Merge pull request 'ci: add pre-merge version-and-changelog check' (!7) from ci/pr-version-check into main

Co-authored-by: Qwen-Coder <qwen-coder@alibabacloud.com>

.gitea/workflows/pr-version-check.yml

@@ -0,0 +1,40 @@
+name: version-changelog
+
+on:
+  pull_request:
+    branches: [main]
+
+jobs:
+  version-changelog:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Check version bump and changelog entry
+        run: |
+          set -e
+          PR_VERSION=$(grep -m1 '"version"' composer.json | sed -E 's/.*"version"[[:space:]]*:[[:space:]]*"([^"]+)".*/\1/')
+          MAIN_VERSION=$(git show origin/main:composer.json | grep -m1 '"version"' | sed -E 's/.*"version"[[:space:]]*:[[:space:]]*"([^"]+)".*/\1/')
+
+          echo "main version: $MAIN_VERSION"
+          echo "PR version:   $PR_VERSION"
+
+          if [ "$MAIN_VERSION" = "$PR_VERSION" ]; then
+            echo "::error::composer.json version ($PR_VERSION) was not bumped from main ($MAIN_VERSION)"
+            exit 1
+          fi
+
+          HIGHEST=$(printf '%s\n%s\n' "$MAIN_VERSION" "$PR_VERSION" | sort -V | tail -n1)
+          if [ "$HIGHEST" != "$PR_VERSION" ]; then
+            echo "::error::composer.json version ($PR_VERSION) is not greater than main's ($MAIN_VERSION)"
+            exit 1
+          fi
+
+          if ! grep -qF "## [$PR_VERSION]" CHANGELOG.md; then
+            echo "::error::CHANGELOG.md is missing a '## [$PR_VERSION]' heading"
+            exit 1
+          fi
+
+          echo "OK: version bumped to $PR_VERSION and documented in CHANGELOG.md"

.gitea/workflows/release.yml

@@ -0,0 +1,100 @@
+name: release
+
+on:
+  push:
+    branches: [main]
+
+env:
+  SERVER_URL: https://git.arthurerlich.de
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.RELEASE_TOKEN }}
+
+      - name: Determine version and guard against re-release
+        id: version
+        run: |
+          set -e
+          VERSION=$(grep -m1 '"version"' composer.json | sed -E 's/.*"version"[[:space:]]*:[[:space:]]*"([^"]+)".*/\1/')
+          TAG="v${VERSION}"
+          echo "version=${VERSION}" >> "$GITHUB_OUTPUT"
+          echo "tag=${TAG}" >> "$GITHUB_OUTPUT"
+          if git ls-remote --tags origin "refs/tags/${TAG}" | grep -q "${TAG}"; then
+            echo "skip=true" >> "$GITHUB_OUTPUT"
+            echo "Tag ${TAG} already exists, nothing to release."
+          else
+            echo "skip=false" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Extract changelog section
+        if: steps.version.outputs.skip == 'false'
+        run: |
+          awk -v ver="${{ steps.version.outputs.version }}" '
+            BEGIN { found=0 }
+            /^## \[/ {
+              if (found) exit
+              if ($0 ~ "\[" ver "\]") { found=1; next }
+            }
+            found { print }
+          ' CHANGELOG.md > release-notes.md
+          cat release-notes.md
+
+      - name: Create and push tag
+        if: steps.version.outputs.skip == 'false'
+        run: |
+          git config user.name "gitea-actions"
+          git config user.email "actions@git.arthurerlich.de"
+          git tag "${{ steps.version.outputs.tag }}"
+          git push origin "${{ steps.version.outputs.tag }}"
+
+      - name: Install shopware-cli
+        if: steps.version.outputs.skip == 'false'
+        run: |
+          curl -sL -o /tmp/shopware-cli.tar.gz \
+            https://github.com/shopware/shopware-cli/releases/latest/download/shopware-cli_Linux_x86_64.tar.gz
+          mkdir -p /tmp/swcli-extract
+          tar -xzf /tmp/shopware-cli.tar.gz -C /tmp/swcli-extract
+          cp /tmp/swcli-extract/shopware-cli /usr/local/bin/shopware-cli
+
+      - name: Validate extension (informational only, does not gate the release)
+        if: steps.version.outputs.skip == 'false'
+        run: shopware-cli extension validate . || true
+
+      - name: Package Store-style zip for the Gitea Release asset
+        if: steps.version.outputs.skip == 'false'
+        run: |
+          shopware-cli extension package . --output-directory .build \
+            --filename "AeonDumpManager-${{ steps.version.outputs.tag }}.zip"
+
+      - name: Build root-level zip for the Composer registry
+        if: steps.version.outputs.skip == 'false'
+        run: git archive --format=zip -o "composer-package-${{ steps.version.outputs.tag }}.zip" "${{ steps.version.outputs.tag }}"
+
+      - name: Create Gitea Release
+        if: steps.version.outputs.skip == 'false'
+        uses: akkuman/gitea-release-action@v1
+        with:
+          server_url: ${{ env.SERVER_URL }}
+          token: ${{ secrets.RELEASE_TOKEN }}
+          tag_name: ${{ steps.version.outputs.tag }}
+          name: ${{ steps.version.outputs.tag }}
+          body_path: release-notes.md
+          files: .build/AeonDumpManager-${{ steps.version.outputs.tag }}.zip
+
+      - name: Publish to Composer registry
+        if: steps.version.outputs.skip == 'false'
+        run: |
+          STATUS=$(curl -s -o /tmp/composer-publish.log -w "%{http_code}" \
+            -u "haylan:${{ secrets.RELEASE_TOKEN }}" \
+            -T "composer-package-${{ steps.version.outputs.tag }}.zip" \
+            "https://git.arthurerlich.de/api/packages/haylan/composer")
+          cat /tmp/composer-publish.log
+          if [ "$STATUS" != "201" ] && [ "$STATUS" != "409" ]; then
+            echo "Unexpected HTTP status $STATUS publishing to the Composer registry"
+            exit 1
+          fi

.gitignore

@@ -12,6 +12,11 @@ composer.phar
 /custom/
 /src/Shopware/Platform
 
+# Frontend
+*.vite/
+**/public/administration/js/
+**/public/static/js/
+
 # Environment
 .env
 .env.local

CHANGELOG.md

@@ -0,0 +1,33 @@
+# Changelog
+
+All notable changes to AeonDumpManager will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.0.2] - 2026-09-21
+
+### Added
+
+- Automated release pipeline: a pre-merge check enforcing a semver version bump and a matching
+  CHANGELOG entry on every PR into `main`, and a post-merge workflow that tags the release,
+  packages the plugin with `shopware-cli`, publishes a Gitea Release with the packaged zip, and
+  publishes the package to this Gitea instance's Composer registry.
+- `main` is now a protected branch: no direct pushes, merges require the version/changelog check
+  to pass.
+
+## [Unreleased]
+
+### Added
+
+- List, create, and delete SQL database dumps from a Settings admin page (nested under Settings, per
+  Shopware's [Add Menu Entry](https://developer.shopware.com/docs/v6.6/guides/plugins/plugins/administration/routing-navigation/add-menu-entry.html)
+  guide) and via `aeon:dump:list`/`aeon:dump:create`/`aeon:dump:remove` console commands.
+- Dumps are created with `mysqldump`/`mariadb-dump` (auto-detected, with an optional `dumpBinaryName`
+  override), gzip-compressed, and stored in the plugin's private Flysystem mount.
+- `maxDumps` auto-purges the oldest dump on creation; `retantionDays` purges dumps and stale job rows
+  on a recurring scheduled task.
+- Admin UI dump creation runs asynchronously via Symfony Messenger with a polling progress bar; console
+  creation runs synchronously.
+- ACL-gated (`aeon_dump_manager.viewer`/`.creator`/`.deleter`), enforced both client-side and
+  server-side.

composer.json

@@ -3,7 +3,7 @@
     "description": "Export database dumps for Shopware 6 environments.",
     "type": "shopware-platform-plugin",
     "license": "MIT",
-    "version": "0.0.1",
+    "version": "0.0.2",
     "keywords": [
         "shopware",
         "shopware6",

src/Controller/DumpController.php

@@ -6,10 +6,14 @@ use AeonDumpManager\MessageQueue\Message\CreateDumpMessage;
 use AeonDumpManager\Service\DumpJobStatusService;
 use AeonDumpManager\Service\DumpLister;
 use AeonDumpManager\Service\DumpService;
-use Shopware\Core\Framework\Api\Route\ApiRouteScope;
+use AeonDumpManager\Service\Exception\DumpNotFoundException;
+use Shopware\Core\Framework\Routing\ApiRouteScope;
 use Shopware\Core\PlatformRequest;
+use Symfony\Component\HttpFoundation\HeaderUtils;
 use Symfony\Component\HttpFoundation\JsonResponse;
 use Symfony\Component\HttpFoundation\Response;
+use Symfony\Component\HttpFoundation\StreamedResponse;
+use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
 use Symfony\Component\Messenger\MessageBusInterface;
 use Symfony\Component\Routing\Annotation\Route;
 
@@ -67,11 +71,41 @@ class DumpController
     )]
     public function delete(string $filename): JsonResponse
     {
-        $this->dumpService->delete($filename);
+        try {
+            $this->dumpService->delete($filename);
+        } catch (DumpNotFoundException $exception) {
+            return new JsonResponse(['message' => $exception->getMessage()], Response::HTTP_NOT_FOUND);
+        }
 
         return new JsonResponse(null, Response::HTTP_NO_CONTENT);
     }
 
+    #[Route(
+        path: '/api/_action/aeon-dump-manager/dumps/{filename}/download',
+        name: 'api.action.aeon_dump_manager.dumps.download',
+        defaults: [PlatformRequest::ATTRIBUTE_ACL => ['aeon_dump_manager.viewer']],
+        methods: ['GET']
+    )]
+    public function download(string $filename): StreamedResponse
+    {
+        try {
+            $stream = $this->dumpService->readStream($filename);
+        } catch (DumpNotFoundException $exception) {
+            throw new NotFoundHttpException($exception->getMessage());
+        }
+
+        $response = new StreamedResponse(static function () use ($stream): void {
+            fpassthru($stream);
+        });
+        $response->headers->set('Content-Type', 'application/gzip');
+        $response->headers->set(
+            'Content-Disposition',
+            HeaderUtils::makeDisposition(HeaderUtils::DISPOSITION_ATTACHMENT, $filename)
+        );
+
+        return $response;
+    }
+
     #[Route(
         path: '/api/_action/aeon-dump-manager/dumps/jobs/{jobId}',
         name: 'api.action.aeon_dump_manager.dumps.jobs.status',

src/Resources/app/administration/src/global.d.ts

@@ -0,0 +1,20 @@
+// Shopware injects its Administration API as untyped globals at runtime; there's
+// no official @shopware-ag type package for plugin authors to install against
+// (per docs/research/admin-dump-manager-ui.md §4), so these are declared loosely
+// as `any` — good enough for editor support, and the build (swc, type-stripping
+// only, no tsc typecheck) doesn't need them at all.
+declare const Shopware: any;
+
+interface Window {
+    Shopware: typeof Shopware;
+}
+
+declare module '*.html.twig' {
+    const template: string;
+    export default template;
+}
+
+declare module '*.json' {
+    const value: Record<string, unknown>;
+    export default value;
+}

src/Resources/app/administration/src/main.ts

@@ -1,7 +1,7 @@
 import DumpApiService from './service/dump-api.service';
 import './module/aeon-dump-manager';
 
-Shopware.Application.addServiceProvider('aeonDumpManagerApiService', (container) => {
+Shopware.Application.addServiceProvider('aeonDumpManagerApiService', (container: { loginService: unknown }) => {
     const initContainer = Shopware.Application.getContainer('init');
 
     return new DumpApiService(initContainer.httpClient, container.loginService);

src/Resources/app/administration/src/module/aeon-dump-manager/index.js

@@ -1,39 +0,0 @@
-import './acl';
-import './page/aeon-dump-manager-list';
-import deDE from './snippet/de-DE.json';
-import enGB from './snippet/en-GB.json';
-
-Shopware.Module.register('aeon-dump-manager', {
-    type: 'plugin',
-    name: 'DumpManager',
-    title: 'aeon-dump-manager.general.mainMenuItemGeneral',
-    description: 'aeon-dump-manager.general.descriptionTextModule',
-    color: '#ff3d58',
-    icon: 'default-object-storage',
-
-    snippets: {
-        'de-DE': deDE,
-        'en-GB': enGB,
-    },
-
-    routes: {
-        list: {
-            component: 'aeon-dump-manager-list',
-            path: 'list',
-            meta: {
-                parentPath: 'sw.settings.index.system',
-                privilege: 'aeon_dump_manager.viewer',
-            },
-        },
-    },
-
-    // Shown as a card on the Settings page's "System" group, next to
-    // Plugins/Cache — matches the locked ACL/menu-naming decision. Plugins
-    // cannot register a first-level main-menu entry.
-    settingsItem: {
-        group: 'system',
-        to: 'aeon.dump.manager.list',
-        icon: 'default-object-storage',
-        privilege: 'aeon_dump_manager.viewer',
-    },
-});

src/Resources/app/administration/src/module/aeon-dump-manager/index.ts

@@ -0,0 +1,53 @@
+import './acl';
+import './page/aeon-dump-manager-list';
+import deDE from './snippet/de-DE.json';
+import enGB from './snippet/en-GB.json';
+
+Shopware.Module.register('aeon-dump-manager', {
+    type: 'plugin',
+    name: 'DumpManager',
+    title: 'aeon-dump-manager.general.mainMenuItemGeneral',
+    description: 'aeon-dump-manager.general.descriptionTextModule',
+    color: '#ff3d58',
+    icon: 'regular-database',
+
+    snippets: {
+        'de-DE': deDE,
+        'en-GB': enGB,
+    },
+
+    routes: {
+        list: {
+            component: 'aeon-dump-manager-list',
+            path: 'list',
+            meta: {
+                parentPath: 'sw.settings.index.system',
+                privilege: 'aeon_dump_manager.viewer',
+            },
+        },
+    },
+
+    // Per https://developer.shopware.com/docs/v6.6/guides/plugins/plugins/administration/routing-navigation/add-menu-entry.html —
+    // plugins can't register a first-level main-menu entry, so this nests
+    // under the core 'sw-settings' navigation node. Clicking Settings in the
+    // main sidebar shows this as a sub-item, landing at #/sw/settings/.
+    navigation: [{
+        id: 'aeon-dump-manager-list',
+        label: 'aeon-dump-manager.general.mainMenuItemGeneral',
+        color: '#ff3d58',
+        path: 'aeon.dump.manager.list',
+        icon: 'regular-database',
+        parent: 'sw-settings',
+        position: 100,
+        privilege: 'aeon_dump_manager.viewer',
+    }],
+
+    // Also shown as a card on the Settings overview page's "System" group,
+    // next to Plugins/Cache — complements the navigation entry above.
+    settingsItem: {
+        group: 'system',
+        to: 'aeon.dump.manager.list',
+        icon: 'regular-database',
+        privilege: 'aeon_dump_manager.viewer',
+    },
+});

src/Resources/app/administration/src/module/aeon-dump-manager/page/aeon-dump-manager-list/aeon-dump-manager-list.html.twig

@@ -4,6 +4,7 @@
         <sw-button
             v-if="acl.can('aeon_dump_manager.creator')"
             variant="primary"
+            :is-loading="pendingJob !== null"
             :disabled="pendingJob !== null"
             @click="onCreate"
         >
@@ -12,54 +13,99 @@
     </template>
 
     <template #content>
-        <sw-card-view>
+        <div class="aeon-dump-manager-list__content">
-            <sw-card>
+            <sw-data-grid
-                <sw-data-grid
+                :data-source="dumps"
-                    :data-source="dumps"
+                :columns="columns"
-                    :columns="columns"
+                :is-loading="isLoading"
-                    :is-loading="isLoading"
+                :show-selection="acl.can('aeon_dump_manager.deleter')"
-                    :show-selection="false"
+                :full-page="true"
-                    identifier="filename"
+                identifier="filename"
-                >
+                @selection-change="onSelectionChange"
-                    <template #before-item-list>
+            >
-                        <tr v-if="pendingJob !== null" class="aeon-dump-manager-list__pending-row">
+                <template #bulk>
-                            <td colspan="3">
+                    <a
-                                <span>{{ $tc('aeon-dump-manager.list.creating') }}</span>
+                        v-if="acl.can('aeon_dump_manager.deleter')"
-                                <sw-progress-bar :max-value="100" :value="pendingJob.percent || 0" />
+                        class="link link-danger aeon-dump-manager-list__bulk-delete"
-                            </td>
+                        role="button"
-                        </tr>
+                        tabindex="0"
-                    </template>
+                        @click="onRequestBulkDelete"
+                        @keydown.enter="onRequestBulkDelete"
+                    >
+                        {{ $tc('aeon-dump-manager.list.bulkDeleteButton', 0, { count: selectionCount }) }}
+                    </a>
+                </template>
 
-                    <template #column-datetime="{ item }">
+                <template #column-datetime="{ item }">
-                        {{ formatDatetime(item.datetime) }}
+                    {{ formatDatetime(item.datetime) }}
-                    </template>
+                </template>
 
-                    <template #column-sizeBytes="{ item }">
+                <template #column-sizeBytes="{ item }">
-                        {{ formatSize(item.sizeBytes) }}
+                    {{ formatSize(item.sizeBytes) }}
-                    </template>
+                </template>
 
-                    <template #actions="{ item }">
+                <template #actions="{ item }">
-                        <sw-context-menu-item
+                    <sw-context-menu-item
-                            v-if="acl.can('aeon_dump_manager.deleter')"
+                        v-if="acl.can('aeon_dump_manager.viewer')"
-                            variant="danger"
+                        @click="onDownload(item.filename)"
-                            @click="onRequestDelete(item.filename)"
+                    >
-                        >
+                        {{ $tc('aeon-dump-manager.list.buttonDownload') }}
-                            {{ $tc('aeon-dump-manager.list.buttonDelete') }}
+                    </sw-context-menu-item>
-                        </sw-context-menu-item>
+                    <sw-context-menu-item
-                    </template>
+                        v-if="acl.can('aeon_dump_manager.deleter')"
+                        variant="danger"
+                        @click="onRequestDelete(item.filename)"
+                    >
+                        {{ $tc('aeon-dump-manager.list.buttonDelete') }}
+                    </sw-context-menu-item>
+                </template>
 
-                    <template #empty-state>
+                <template #empty-state>
-                        {{ $tc('aeon-dump-manager.list.empty') }}
+                    {{ $tc('aeon-dump-manager.list.empty') }}
-                    </template>
+                </template>
-                </sw-data-grid>
+            </sw-data-grid>
-            </sw-card>
+        </div>
-        </sw-card-view>
     </template>
 
+    {% block aeon_dump_manager_list_progress_modal %}
+    <sw-modal
+        v-if="pendingJob !== null"
+        :title="$tc('aeon-dump-manager.list.progressTitle')"
+        variant="small"
+        class="aeon-dump-manager-list__progress-modal"
+        @modal-close="onCloseProgressModal"
+    >
+        <div class="aeon-dump-manager-list__progress-wrapper">
+            <template v-if="pendingJob.status === 'done'">
+                <sw-alert variant="success">
+                    {{ $tc('aeon-dump-manager.list.createSuccess') }}
+                </sw-alert>
+            </template>
+            <template v-else-if="pendingJob.status === 'failed'">
+                <sw-alert variant="error">
+                    {{ $tc('aeon-dump-manager.list.createFailed', 0, { error: pendingJob.errorMessage || '' }) }}
+                </sw-alert>
+            </template>
+            <template v-else>
+                <sw-progress-bar
+                    :value="pendingJob.percent || 0"
+                    :max-value="100"
+                />
+                <span class="aeon-dump-manager-list__progress-text">
+                    {{ $tc('aeon-dump-manager.list.progressText') }}
+                </span>
+            </template>
+        </div>
+    </sw-modal>
+    {% endblock %}
+
     <sw-confirm-modal
-        v-if="deleteFilename !== null"
+        v-if="deleteFilenames !== null"
         :title="$tc('aeon-dump-manager.list.confirmDeleteTitle')"
-        :text="$tc('aeon-dump-manager.list.confirmDeleteText', 0, { filename: deleteFilename })"
+        :text="deleteFilenames.length > 1
+            ? $tc('aeon-dump-manager.list.confirmDeleteTextMultiple', 0, { count: deleteFilenames.length })
+            : $tc('aeon-dump-manager.list.confirmDeleteText', 0, { filename: deleteFilenames[0] })"
+        type="delete"
         @confirm="onConfirmDelete"
         @cancel="onCancelDelete"
         @close="onCancelDelete"

src/Resources/app/administration/src/module/aeon-dump-manager/page/aeon-dump-manager-list/index.js

@@ -1,137 +0,0 @@
-import template from './aeon-dump-manager-list.html.twig';
-
-const { Component } = Shopware;
-
-Component.register('aeon-dump-manager-list', {
-    template,
-
-    inject: ['aeonDumpManagerApiService', 'acl'],
-
-    data() {
-        return {
-            dumps: [],
-            isLoading: false,
-            pendingJob: null,
-            deleteFilename: null,
-            pollTimer: null,
-        };
-    },
-
-    computed: {
-        columns() {
-            return [
-                {
-                    property: 'datetime',
-                    label: this.$tc('aeon-dump-manager.list.columnDatetime'),
-                    allowResize: true,
-                },
-                {
-                    property: 'filename',
-                    label: this.$tc('aeon-dump-manager.list.columnFilename'),
-                    allowResize: true,
-                },
-                {
-                    property: 'sizeBytes',
-                    label: this.$tc('aeon-dump-manager.list.columnSize'),
-                    align: 'right',
-                    allowResize: true,
-                },
-            ];
-        },
-    },
-
-    created() {
-        this.loadList();
-    },
-
-    beforeDestroy() {
-        this.stopPolling();
-    },
-
-    methods: {
-        loadList() {
-            this.isLoading = true;
-
-            return this.aeonDumpManagerApiService.getList()
-                .then((response) => {
-                    this.dumps = response.dumps;
-                })
-                .finally(() => {
-                    this.isLoading = false;
-                });
-        },
-
-        formatDatetime(value) {
-            return new Date(value).toLocaleString();
-        },
-
-        formatSize(bytes) {
-            return Shopware.Utils.format.fileSize(bytes);
-        },
-
-        onCreate() {
-            this.pendingJob = { percent: 0, status: 'pending' };
-
-            this.aeonDumpManagerApiService.create()
-                .then((response) => {
-                    this.pollJobStatus(response.jobId);
-                })
-                .catch((error) => {
-                    this.pendingJob = null;
-                    this.createNotificationError({
-                        message: this.$tc('aeon-dump-manager.list.createFailed', 0, { error: error.message }),
-                    });
-                });
-        },
-
-        pollJobStatus(jobId) {
-            this.stopPolling();
-
-            this.pollTimer = window.setInterval(() => {
-                this.aeonDumpManagerApiService.getJobStatus(jobId).then((job) => {
-                    if (job.status === 'done') {
-                        this.stopPolling();
-                        this.pendingJob = null;
-                        this.createNotificationSuccess({ message: this.$tc('aeon-dump-manager.list.createSuccess') });
-                        this.loadList();
-                        return;
-                    }
-
-                    if (job.status === 'failed') {
-                        this.stopPolling();
-                        this.pendingJob = null;
-                        this.createNotificationError({
-                            message: this.$tc('aeon-dump-manager.list.createFailed', 0, { error: job.errorMessage }),
-                        });
-                        return;
-                    }
-
-                    this.pendingJob = job;
-                });
-            }, 2000);
-        },
-
-        stopPolling() {
-            if (this.pollTimer !== null) {
-                window.clearInterval(this.pollTimer);
-                this.pollTimer = null;
-            }
-        },
-
-        onRequestDelete(filename) {
-            this.deleteFilename = filename;
-        },
-
-        onCancelDelete() {
-            this.deleteFilename = null;
-        },
-
-        onConfirmDelete() {
-            const filename = this.deleteFilename;
-            this.deleteFilename = null;
-
-            return this.aeonDumpManagerApiService.remove(filename)
-                .then(() => this.loadList());
-        },
-    },
-});

src/Resources/app/administration/src/module/aeon-dump-manager/page/aeon-dump-manager-list/index.ts

@@ -0,0 +1,215 @@
+import template from './aeon-dump-manager-list.html.twig';
+import type DumpApiService, { DumpFile, DumpJob } from '../../../../service/dump-api.service';
+
+const { Component, Mixin } = Shopware;
+
+interface PendingJob {
+    status: string;
+    percent: number | null;
+    errorMessage?: string | null;
+}
+
+const CREATE_MODAL_AUTO_CLOSE_MS = 1500;
+
+interface ComponentData {
+    dumps: DumpFile[];
+    isLoading: boolean;
+    pendingJob: PendingJob | null;
+    deleteFilenames: string[] | null;
+    selection: Record<string, DumpFile>;
+    pollTimer: number | null;
+}
+
+interface ComponentInstance extends ComponentData {
+    aeonDumpManagerApiService: DumpApiService;
+    $tc: (key: string, count?: number, values?: Record<string, unknown>) => string;
+    createNotificationError: (options: { message: string }) => void;
+    createNotificationSuccess: (options: { message: string }) => void;
+    loadList: () => Promise<void>;
+    stopPolling: () => void;
+    pollJobStatus: (jobId: string) => void;
+    selectionCount: number;
+}
+
+Component.register('aeon-dump-manager-list', {
+    template,
+
+    // Provides createNotificationSuccess/createNotificationError, used below.
+    mixins: [Mixin.getByName('notification')],
+
+    inject: ['aeonDumpManagerApiService', 'acl'],
+
+    data(): ComponentData {
+        return {
+            dumps: [],
+            isLoading: false,
+            pendingJob: null,
+            deleteFilenames: null,
+            selection: {},
+            pollTimer: null,
+        };
+    },
+
+    computed: {
+        columns() {
+            return [
+                {
+                    property: 'datetime',
+                    label: this.$tc('aeon-dump-manager.list.columnDatetime'),
+                    allowResize: true,
+                },
+                {
+                    property: 'filename',
+                    label: this.$tc('aeon-dump-manager.list.columnFilename'),
+                    allowResize: true,
+                },
+                {
+                    property: 'sizeBytes',
+                    label: this.$tc('aeon-dump-manager.list.columnSize'),
+                    align: 'right',
+                    allowResize: true,
+                },
+            ];
+        },
+
+        selectionCount(this: ComponentInstance): number {
+            return Object.keys(this.selection).length;
+        },
+    },
+
+    created(this: ComponentInstance) {
+        this.loadList();
+    },
+
+    beforeDestroy(this: ComponentInstance) {
+        this.stopPolling();
+    },
+
+    methods: {
+        loadList(this: ComponentInstance): Promise<void> {
+            this.isLoading = true;
+
+            return this.aeonDumpManagerApiService.getList()
+                .then((response) => {
+                    this.dumps = response.dumps;
+                })
+                .finally(() => {
+                    this.isLoading = false;
+                });
+        },
+
+        formatDatetime(value: string): string {
+            return new Date(value).toLocaleString();
+        },
+
+        formatSize(bytes: number): string {
+            return Shopware.Utils.format.fileSize(bytes);
+        },
+
+        onSelectionChange(this: ComponentInstance, selection: Record<string, DumpFile>) {
+            this.selection = selection;
+        },
+
+        onCreate(this: ComponentInstance) {
+            this.pendingJob = { percent: 0, status: 'pending' };
+
+            this.aeonDumpManagerApiService.create()
+                .then((response) => {
+                    this.pollJobStatus(response.jobId);
+                })
+                .catch((error: Error) => {
+                    // Shown in the progress modal itself, not a notification —
+                    // stays open so the user can actually read what went wrong.
+                    this.pendingJob = { status: 'failed', percent: null, errorMessage: error.message };
+                });
+        },
+
+        pollJobStatus(this: ComponentInstance, jobId: string) {
+            this.stopPolling();
+
+            this.pollTimer = window.setInterval(() => {
+                this.aeonDumpManagerApiService.getJobStatus(jobId).then((job: DumpJob) => {
+                    this.pendingJob = job;
+
+                    if (job.status === 'done') {
+                        this.stopPolling();
+                        this.loadList();
+                        window.setTimeout(() => {
+                            this.pendingJob = null;
+                        }, CREATE_MODAL_AUTO_CLOSE_MS);
+                        return;
+                    }
+
+                    if (job.status === 'failed') {
+                        this.stopPolling();
+                    }
+                });
+            }, 2000);
+        },
+
+        stopPolling(this: ComponentInstance) {
+            if (this.pollTimer !== null) {
+                window.clearInterval(this.pollTimer);
+                this.pollTimer = null;
+            }
+        },
+
+        onCloseProgressModal(this: ComponentInstance) {
+            this.stopPolling();
+            this.pendingJob = null;
+        },
+
+        onDownload(this: ComponentInstance, filename: string) {
+            this.aeonDumpManagerApiService.download(filename)
+                .then((blob) => {
+                    const url = window.URL.createObjectURL(blob);
+                    const link = document.createElement('a');
+                    link.href = url;
+                    link.download = filename;
+                    document.body.appendChild(link);
+                    link.click();
+                    document.body.removeChild(link);
+                    window.URL.revokeObjectURL(url);
+                })
+                .catch((error: Error) => {
+                    this.createNotificationError({
+                        message: this.$tc('aeon-dump-manager.list.downloadFailed', 0, { error: error.message }),
+                    });
+                });
+        },
+
+        onRequestDelete(this: ComponentInstance, filename: string) {
+            this.deleteFilenames = [filename];
+        },
+
+        onRequestBulkDelete(this: ComponentInstance) {
+            this.deleteFilenames = Object.keys(this.selection);
+        },
+
+        onCancelDelete(this: ComponentInstance) {
+            this.deleteFilenames = null;
+        },
+
+        onConfirmDelete(this: ComponentInstance): Promise<void> {
+            const filenames = this.deleteFilenames as string[];
+            this.deleteFilenames = null;
+
+            // Optimistic UI update: pull the rows out immediately rather than
+            // waiting on a full reload, so the grid never looks stale even if
+            // loadList() is slow or a later delete in the batch fails.
+            this.dumps = this.dumps.filter((dumpFile) => !filenames.includes(dumpFile.filename));
+            this.selection = {};
+
+            return Promise.all(filenames.map((filename) => this.aeonDumpManagerApiService.remove(filename)))
+                .then(() => this.loadList())
+                .catch((error: Error) => {
+                    this.createNotificationError({
+                        message: this.$tc('aeon-dump-manager.list.deleteFailed', 0, { error: error.message }),
+                    });
+                    // A delete failed after the optimistic removal — reload to
+                    // show the real state rather than leave a wrong guess on screen.
+                    return this.loadList();
+                });
+        },
+    },
+});

src/Resources/app/administration/src/module/aeon-dump-manager/snippet/de-DE.json

@@ -9,13 +9,19 @@
             "columnDatetime": "Erstellt am",
             "columnSize": "Größe",
             "buttonCreate": "Dump erstellen",
+            "buttonDownload": "Herunterladen",
             "buttonDelete": "Löschen",
+            "bulkDeleteButton": "Auswahl löschen ({count})",
             "confirmDeleteTitle": "Dump löschen?",
             "confirmDeleteText": "Möchten Sie \"{filename}\" wirklich löschen? Dies kann nicht rückgängig gemacht werden.",
+            "confirmDeleteTextMultiple": "Möchten Sie {count} Dumps wirklich löschen? Dies kann nicht rückgängig gemacht werden.",
             "empty": "Keine Dumps gefunden.",
-            "creating": "Dump wird erstellt…",
+            "progressTitle": "Dump wird erstellt",
+            "progressText": "Dump wird erstellt…",
             "createFailed": "Dump konnte nicht erstellt werden: {error}",
-            "createSuccess": "Dump erstellt."
+            "createSuccess": "Dump erstellt.",
+            "deleteFailed": "Dump konnte nicht gelöscht werden: {error}",
+            "downloadFailed": "Dump konnte nicht heruntergeladen werden: {error}"
         }
     }
 }

src/Resources/app/administration/src/module/aeon-dump-manager/snippet/en-GB.json

@@ -9,13 +9,19 @@
             "columnDatetime": "Created at",
             "columnSize": "Size",
             "buttonCreate": "Create dump",
+            "buttonDownload": "Download",
             "buttonDelete": "Delete",
+            "bulkDeleteButton": "Delete selected ({count})",
             "confirmDeleteTitle": "Delete dump?",
             "confirmDeleteText": "Are you sure you want to delete \"{filename}\"? This cannot be undone.",
+            "confirmDeleteTextMultiple": "Are you sure you want to delete {count} dumps? This cannot be undone.",
             "empty": "No dumps found.",
-            "creating": "Creating dump…",
+            "progressTitle": "Creating dump",
+            "progressText": "Creating dump…",
             "createFailed": "Could not create dump: {error}",
-            "createSuccess": "Dump created."
+            "createSuccess": "Dump created.",
+            "deleteFailed": "Could not delete dump: {error}",
+            "downloadFailed": "Could not download dump: {error}"
         }
     }
 }

src/Resources/app/administration/src/service/dump-api.service.js

@@ -1,31 +0,0 @@
-const { ApiService } = Shopware.Classes;
-
-export default class DumpApiService extends ApiService {
-    constructor(httpClient, loginService, apiEndpoint = 'aeon-dump-manager') {
-        super(httpClient, loginService, apiEndpoint);
-    }
-
-    getList() {
-        return this.httpClient
-            .get('/_action/aeon-dump-manager/dumps', { headers: this.getBasicHeaders() })
-            .then((response) => ApiService.handleResponse(response));
-    }
-
-    create() {
-        return this.httpClient
-            .post('/_action/aeon-dump-manager/dumps', {}, { headers: this.getBasicHeaders() })
-            .then((response) => ApiService.handleResponse(response));
-    }
-
-    remove(filename) {
-        return this.httpClient
-            .delete(`/_action/aeon-dump-manager/dumps/${encodeURIComponent(filename)}`, { headers: this.getBasicHeaders() })
-            .then((response) => ApiService.handleResponse(response));
-    }
-
-    getJobStatus(jobId) {
-        return this.httpClient
-            .get(`/_action/aeon-dump-manager/dumps/jobs/${encodeURIComponent(jobId)}`, { headers: this.getBasicHeaders() })
-            .then((response) => ApiService.handleResponse(response));
-    }
-}

src/Resources/app/administration/src/service/dump-api.service.ts

@@ -0,0 +1,78 @@
+export interface DumpFile {
+    filename: string;
+    datetime: string;
+    sizeBytes: number;
+}
+
+export interface DumpList {
+    dumps: DumpFile[];
+}
+
+export interface CreateDumpResponse {
+    jobId: string;
+}
+
+export type DumpJobStatus = 'pending' | 'running' | 'done' | 'failed';
+
+export interface DumpJob {
+    id: string;
+    status: DumpJobStatus;
+    percent: number | null;
+    filename: string | null;
+    errorMessage: string | null;
+}
+
+// Shopware.Classes.ApiService has no official type package for plugin authors
+// (per docs/research/admin-dump-manager-ui.md §4) — redeclaring the inherited
+// member this class actually uses keeps everything below typed without one.
+// `declare` is required here: a normal field declaration compiles to a real
+// `this.httpClient = void 0` in the constructor, which runs *after* `super()`
+// and silently clobbers the value the base class just set.
+const { ApiService } = Shopware.Classes;
+
+export default class DumpApiService extends ApiService {
+    protected declare httpClient: {
+        get: (url: string, config?: unknown) => Promise<unknown>;
+        post: (url: string, data: unknown, config?: unknown) => Promise<unknown>;
+        delete: (url: string, config?: unknown) => Promise<unknown>;
+    };
+
+    protected declare getBasicHeaders: (additionalHeaders?: Record<string, string>) => Record<string, string>;
+
+    constructor(httpClient: unknown, loginService: unknown, apiEndpoint = 'aeon-dump-manager') {
+        super(httpClient, loginService, apiEndpoint);
+    }
+
+    getList(): Promise<DumpList> {
+        return this.httpClient
+            .get('/_action/aeon-dump-manager/dumps', { headers: this.getBasicHeaders() })
+            .then((response: unknown) => ApiService.handleResponse(response));
+    }
+
+    create(): Promise<CreateDumpResponse> {
+        return this.httpClient
+            .post('/_action/aeon-dump-manager/dumps', {}, { headers: this.getBasicHeaders() })
+            .then((response: unknown) => ApiService.handleResponse(response));
+    }
+
+    remove(filename: string): Promise<void> {
+        return this.httpClient
+            .delete(`/_action/aeon-dump-manager/dumps/${encodeURIComponent(filename)}`, { headers: this.getBasicHeaders() })
+            .then((response: unknown) => ApiService.handleResponse(response));
+    }
+
+    getJobStatus(jobId: string): Promise<DumpJob> {
+        return this.httpClient
+            .get(`/_action/aeon-dump-manager/dumps/jobs/${encodeURIComponent(jobId)}`, { headers: this.getBasicHeaders() })
+            .then((response: unknown) => ApiService.handleResponse(response));
+    }
+
+    download(filename: string): Promise<Blob> {
+        return this.httpClient
+            .get(`/_action/aeon-dump-manager/dumps/${encodeURIComponent(filename)}/download`, {
+                headers: this.getBasicHeaders(),
+                responseType: 'blob',
+            })
+            .then((response: unknown) => ApiService.handleResponse(response) as Blob);
+    }
+}

src/Resources/app/administration/src/tsconfig.json

@@ -0,0 +1,13 @@
+{
+    "compilerOptions": {
+        "target": "es2022",
+        "module": "esnext",
+        "moduleResolution": "bundler",
+        "strict": false,
+        "noEmit": true,
+        "skipLibCheck": true,
+        "allowJs": true,
+        "esModuleInterop": true
+    },
+    "include": ["**/*.ts", "global.d.ts"]
+}

src/Resources/config/config.xml

@@ -6,12 +6,12 @@
     <card>
         <title>Minimal configuration</title>
 
-        <input-field type="number">
+        <input-field type="int">
             <name>maxDumps</name>
             <label>Maximum allowed dumps to exist</label>
             <defaultValue>6</defaultValue>
         </input-field>
-        <input-field type="number">
+        <input-field type="int">
             <name>retantionDays</name>
             <label>How many Days the dumps kept in the Storage. 0 Means unlimited</label>
             <defaultValue>0</defaultValue>
@@ -19,7 +19,6 @@
         <input-field type="text">
             <name>dumpBinaryName</name>
             <label>Name of the mysqldump/mariadb-dump binary to look up on PATH (e.g. if your distro renamed it). Leave empty to auto-detect.</label>
-            <defaultValue>""</defaultValue>
         </input-field>
     </card>
 

src/Resources/config/services.xml

@@ -5,81 +5,82 @@
            xsi:schemaLocation="http://symfony.com/schema/dic/services http://symfony.com/schema/dic/services/services-1.0.xsd">
 
     <services>
-
         <!-- Services -->
 
         <service id="Symfony\Component\Process\ExecutableFinder"/>
 
-        <service id="AeonDumpManager\Service\DumpFilenameParser"/>
+        <service id="aeon_dump_manager.dump_filename_parser" class="AeonDumpManager\Service\DumpFilenameParser"/>
 
-        <service id="AeonDumpManager\Service\DumpBinaryLocator">
+        <service id="aeon_dump_manager.dump_binary_locator" class="AeonDumpManager\Service\DumpBinaryLocator">
             <argument type="service" id="Doctrine\DBAL\Connection"/>
             <argument type="service" id="Shopware\Core\System\SystemConfig\SystemConfigService"/>
             <argument type="service" id="Symfony\Component\Process\ExecutableFinder"/>
         </service>
 
-        <service id="AeonDumpManager\Service\DumpJobStatusService">
+        <service id="aeon_dump_manager.dump_job_status_service" class="AeonDumpManager\Service\DumpJobStatusService">
             <argument type="service" id="Doctrine\DBAL\Connection"/>
         </service>
 
-        <service id="AeonDumpManager\Service\DumpLister">
+        <service id="aeon_dump_manager.dump_lister" class="AeonDumpManager\Service\DumpLister">
             <argument type="service" id="aeon_dump_manager.filesystem.private"/>
-            <argument type="service" id="AeonDumpManager\Service\DumpFilenameParser"/>
+            <argument type="service" id="aeon_dump_manager.dump_filename_parser"/>
         </service>
 
-        <service id="AeonDumpManager\Service\DumpService">
+        <service id="aeon_dump_manager.dump_service" class="AeonDumpManager\Service\DumpService">
-            <argument type="service" id="AeonDumpManager\Service\DumpLister"/>
+            <argument type="service" id="aeon_dump_manager.dump_lister"/>
             <argument type="service" id="aeon_dump_manager.filesystem.private"/>
-            <argument type="service" id="AeonDumpManager\Service\DumpBinaryLocator"/>
+            <argument type="service" id="aeon_dump_manager.dump_binary_locator"/>
             <argument type="service" id="Doctrine\DBAL\Connection"/>
             <argument type="service" id="Shopware\Core\System\SystemConfig\SystemConfigService"/>
-            <argument type="service" id="AeonDumpManager\Service\DumpFilenameParser"/>
+            <argument type="service" id="aeon_dump_manager.dump_filename_parser"/>
         </service>
 
         <!-- Async create job -->
 
-        <service id="AeonDumpManager\MessageQueue\Handler\CreateDumpHandler">
+        <service id="aeon_dump_manager.message_queue.create_dump_handler" class="AeonDumpManager\MessageQueue\Handler\CreateDumpHandler">
-            <argument type="service" id="AeonDumpManager\Service\DumpService"/>
+            <argument type="service" id="aeon_dump_manager.dump_service"/>
-            <argument type="service" id="AeonDumpManager\Service\DumpJobStatusService"/>
+            <argument type="service" id="aeon_dump_manager.dump_job_status_service"/>
+            <tag name="messenger.message_handler"/>
         </service>
 
         <!-- Retention -->
 
-        <service id="AeonDumpManager\ScheduledTask\PurgeDumpsTask">
+        <service id="aeon_dump_manager.scheduled_task.purge_dumps_task" class="AeonDumpManager\ScheduledTask\PurgeDumpsTask">
             <tag name="shopware.scheduled.task"/>
         </service>
 
-        <service id="AeonDumpManager\ScheduledTask\PurgeDumpsTaskHandler">
+        <service id="aeon_dump_manager.scheduled_task.purge_dumps_task_handler" class="AeonDumpManager\ScheduledTask\PurgeDumpsTaskHandler">
             <argument type="service" id="scheduled_task.repository"/>
             <argument type="service" id="logger"/>
-            <argument type="service" id="AeonDumpManager\Service\DumpService"/>
+            <argument type="service" id="aeon_dump_manager.dump_service"/>
-            <argument type="service" id="AeonDumpManager\Service\DumpJobStatusService"/>
+            <argument type="service" id="aeon_dump_manager.dump_job_status_service"/>
             <argument type="service" id="Shopware\Core\System\SystemConfig\SystemConfigService"/>
+            <tag name="messenger.message_handler" handles="AeonDumpManager\ScheduledTask\PurgeDumpsTask"/>
         </service>
 
         <!-- Console commands -->
 
-        <service id="AeonDumpManager\Command\DumpListCommand">
+        <service id="aeon_dump_manager.command.dump_list" class="AeonDumpManager\Command\DumpListCommand">
-            <argument type="service" id="AeonDumpManager\Service\DumpLister"/>
+            <argument type="service" id="aeon_dump_manager.dump_lister"/>
             <tag name="console.command"/>
         </service>
 
-        <service id="AeonDumpManager\Command\DumpCreateCommand">
+        <service id="aeon_dump_manager.command.dump_create" class="AeonDumpManager\Command\DumpCreateCommand">
-            <argument type="service" id="AeonDumpManager\Service\DumpService"/>
+            <argument type="service" id="aeon_dump_manager.dump_service"/>
             <tag name="console.command"/>
         </service>
 
-        <service id="AeonDumpManager\Command\DumpRemoveCommand">
+        <service id="aeon_dump_manager.command.dump_remove" class="AeonDumpManager\Command\DumpRemoveCommand">
-            <argument type="service" id="AeonDumpManager\Service\DumpService"/>
+            <argument type="service" id="aeon_dump_manager.dump_service"/>
             <tag name="console.command"/>
         </service>
 
         <!-- Admin API controller -->
 
         <service id="AeonDumpManager\Controller\DumpController" public="true">
-            <argument type="service" id="AeonDumpManager\Service\DumpLister"/>
+            <argument type="service" id="aeon_dump_manager.dump_lister"/>
-            <argument type="service" id="AeonDumpManager\Service\DumpService"/>
+            <argument type="service" id="aeon_dump_manager.dump_service"/>
-            <argument type="service" id="AeonDumpManager\Service\DumpJobStatusService"/>
+            <argument type="service" id="aeon_dump_manager.dump_job_status_service"/>
             <argument type="service" id="messenger.default_bus"/>
         </service>
 

src/Service/DumpBinaryLocator.php

@@ -40,6 +40,9 @@ class DumpBinaryLocator
 
     private function isMariaDb(): bool
     {
-        return MySqlVariant::isMariaDb($this->connection->getServerVersion());
+        // Connection::getServerVersion() is private in the DBAL version this
+        // repo pins against — SELECT VERSION() is the stable public way to get
+        // the same string.
+        return MySqlVariant::isMariaDb((string) $this->connection->fetchOne('SELECT VERSION()'));
     }
 }

src/Service/DumpService.php

@@ -71,6 +71,23 @@ class DumpService
         $this->aeonDumpManagerFilesystemPrivate->delete($path);
     }
 
+    /**
+     * @return resource
+     */
+    public function readStream(string $filename)
+    {
+        if (!$this->filenameParser->isValid($filename)) {
+            throw DumpNotFoundException::create($filename);
+        }
+
+        $path = DumpLister::path($filename);
+        if (!$this->aeonDumpManagerFilesystemPrivate->fileExists($path)) {
+            throw DumpNotFoundException::create($filename);
+        }
+
+        return $this->aeonDumpManagerFilesystemPrivate->readStream($path);
+    }
+
     public function enforceMaxDumps(): void
     {
         $maxDumps = $this->systemConfigService->getInt('AeonDumpManager.config.maxDumps');