Standardize API response envelopes: use items for collection responses and update tests

backend/app/routers/jails.py

@@ -19,6 +19,7 @@ Provides CRUD and control operations for fail2ban jails:
 
 from __future__ import annotations
 
+import asyncio
 from typing import Annotated
 
 from fastapi import APIRouter, Body, HTTPException, Path, status
@@ -34,6 +35,7 @@ from app.dependencies import (
 from app.models.ban import JailBannedIpsResponse
 from app.models.jail import (
     IgnoreIpRequest,
+    IgnoreListResponse,
     JailCommandResponse,
     JailDetailResponse,
     JailListResponse,
@@ -103,7 +105,16 @@ async def get_jail(
         HTTPException: 404 when the jail does not exist.
         HTTPException: 502 when fail2ban is unreachable.
     """
-    return await jail_service.get_jail(socket_path, name)
+    jail, ignore_list, ignore_self = await asyncio.gather(
+        jail_service.get_jail(socket_path, name),
+        jail_service.get_ignore_list(socket_path, name),
+        jail_service.get_ignore_self(socket_path, name),
+    )
+    return JailDetailResponse(
+        jail=jail,
+        ignore_list=ignore_list,
+        ignore_self=ignore_self,
+    )
 
 
 # ---------------------------------------------------------------------------
@@ -278,14 +289,14 @@ class _IgnoreSelfRequest(IgnoreIpRequest):
 
 @router.get(
     "/{name}/ignoreip",
-    response_model=list[str],
+    response_model=IgnoreListResponse,
     summary="List the ignore IPs for a jail",
 )
 async def get_ignore_list(
     _auth: AuthDep,
     name: _NamePath,
     socket_path: Fail2BanSocketDep,
-) -> list[str]:
+) -> IgnoreListResponse:
     """Return the current ignore list (IP whitelist) for a fail2ban jail.
 
     Args:
@@ -299,7 +310,8 @@ async def get_ignore_list(
         HTTPException: 404 when the jail does not exist.
         HTTPException: 502 when fail2ban is unreachable.
     """
-    return await jail_service.get_ignore_list(socket_path, name)
+    ignore_list = await jail_service.get_ignore_list(socket_path, name)
+    return IgnoreListResponse(items=ignore_list, total=len(ignore_list))
 
 
 @router.post(