feat: package rollback support (#161)

* implement support of rollback handler

* react interface for the rollback

src/ahriman/web/views/base.py

@@ -227,7 +227,7 @@ class BaseView(View, CorsViewMixin):
         extract repository from request
 
         Returns:
-            RepositoryIde: repository if possible to construct and first one otherwise
+            RepositoryId: repository if possible to construct and first one otherwise
         """
         architecture = self.request.query.get("architecture")
         name = self.request.query.get("repository")

src/ahriman/web/views/v1/service/add.py

@@ -44,7 +44,6 @@ class AddView(BaseView):
         description="Add new package(s) from AUR",
         permission=POST_PERMISSION,
         error_400_enabled=True,
-        error_404_description="Repository is unknown",
         schema=ProcessIdSchema,
         query_schema=RepositoryIdSchema,
         body_schema=PackagePatchSchema,

src/ahriman/web/views/v1/service/rebuild.py

@@ -43,7 +43,6 @@ class RebuildView(BaseView):
         description="Rebuild packages which depend on specified one",
         permission=POST_PERMISSION,
         error_400_enabled=True,
-        error_404_description="Repository is unknown",
         schema=ProcessIdSchema,
         query_schema=RepositoryIdSchema,
         body_schema=PackageNamesSchema,

src/ahriman/web/views/v1/service/remove.py

@@ -43,7 +43,6 @@ class RemoveView(BaseView):
         description="Remove specified packages from the repository",
         permission=POST_PERMISSION,
         error_400_enabled=True,
-        error_404_description="Repository is unknown",
         schema=ProcessIdSchema,
         query_schema=RepositoryIdSchema,
         body_schema=PackageNamesSchema,

src/ahriman/web/views/v1/service/request.py

@@ -44,7 +44,6 @@ class RequestView(BaseView):
         description="Request new package(s) to be added from AUR",
         permission=POST_PERMISSION,
         error_400_enabled=True,
-        error_404_description="Repository is unknown",
         schema=ProcessIdSchema,
         query_schema=RepositoryIdSchema,
         body_schema=PackagePatchSchema,

src/ahriman/web/views/v1/service/rollback.py

@@ -0,0 +1,77 @@
+#
+# Copyright (c) 2021-2026 ahriman team.
+#
+# This file is part of ahriman
+# (see https://github.com/arcan1s/ahriman).
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see <http://www.gnu.org/licenses/>.
+#
+from aiohttp.web import HTTPBadRequest, Response
+from typing import ClassVar
+
+from ahriman.models.user_access import UserAccess
+from ahriman.web.apispec.decorators import apidocs
+from ahriman.web.schemas import ProcessIdSchema, RepositoryIdSchema, RollbackSchema
+from ahriman.web.views.base import BaseView
+
+
+class RollbackView(BaseView):
+    """
+    package rollback web view
+
+    Attributes:
+        POST_PERMISSION(UserAccess): (class attribute) post permissions of self
+    """
+
+    POST_PERMISSION: ClassVar[UserAccess] = UserAccess.Full
+    ROUTES = ["/api/v1/service/rollback"]
+
+    @apidocs(
+        tags=["Actions"],
+        summary="Rollback package",
+        description="Rollback package to specified version",
+        permission=POST_PERMISSION,
+        error_400_enabled=True,
+        schema=ProcessIdSchema,
+        query_schema=RepositoryIdSchema,
+        body_schema=RollbackSchema,
+    )
+    async def post(self) -> Response:
+        """
+        run package rollback
+
+        Returns:
+            Response: 200 with spawned process id
+
+        Raises:
+            HTTPBadRequest: if bad data is supplied
+        """
+        try:
+            data = await self.request.json()
+            package = self.get_non_empty(lambda key: data[key], "package")
+            version = self.get_non_empty(lambda key: data[key], "version")
+        except Exception as ex:
+            raise HTTPBadRequest(reason=str(ex))
+
+        repository_id = self.repository_id()
+        username = await self.username()
+        process_id = self.spawner.packages_rollback(
+            repository_id,
+            package,
+            version,
+            username,
+            hold=data.get("hold", True),
+        )
+
+        return self.json_response({"process_id": process_id})

src/ahriman/web/views/v1/service/update.py

@@ -43,14 +43,13 @@ class UpdateView(BaseView):
         description="Run repository update process",
         permission=POST_PERMISSION,
         error_400_enabled=True,
-        error_404_description="Repository is unknown",
         schema=ProcessIdSchema,
         query_schema=RepositoryIdSchema,
         body_schema=UpdateFlagsSchema,
     )
     async def post(self) -> Response:
         """
-        run repository update. No parameters supported here
+        run repository update
 
         Returns:
             Response: 200 with spawned process id

src/ahriman/web/views/v1/service/upload.py

@@ -118,7 +118,6 @@ class UploadView(BaseView):
         permission=POST_PERMISSION,
         response_code=HTTPCreated,
         error_400_enabled=True,
-        error_404_description="Repository is unknown",
         query_schema=RepositoryIdSchema,
         body_schema=FileSchema,
         body_location="form",