update: Major Overhault to all subsystems

backend/firmware/router.py

@@ -4,7 +4,7 @@ from typing import Optional
 
 from auth.models import TokenPayload
 from auth.dependencies import require_permission
-from firmware.models import FirmwareVersion, FirmwareListResponse, FirmwareLatestResponse
+from firmware.models import FirmwareVersion, FirmwareListResponse, FirmwareMetadataResponse, UpdateType
 from firmware import service
 
 router = APIRouter(prefix="/api/firmware", tags=["firmware"])
@@ -15,6 +15,8 @@ async def upload_firmware(
     hw_type: str = Form(...),
     channel: str = Form(...),
     version: str = Form(...),
+    update_type: UpdateType = Form(UpdateType.mandatory),
+    min_fw_version: Optional[str] = Form(None),
     notes: Optional[str] = Form(None),
     file: UploadFile = File(...),
     _user: TokenPayload = Depends(require_permission("manufacturing", "add")),
@@ -25,6 +27,8 @@ async def upload_firmware(
         channel=channel,
         version=version,
         file_bytes=file_bytes,
+        update_type=update_type,
+        min_fw_version=min_fw_version,
         notes=notes,
     )
 
@@ -39,7 +43,7 @@ def list_firmware(
     return FirmwareListResponse(firmware=items, total=len(items))
 
 
-@router.get("/{hw_type}/{channel}/latest", response_model=FirmwareLatestResponse)
+@router.get("/{hw_type}/{channel}/latest", response_model=FirmwareMetadataResponse)
 def get_latest_firmware(hw_type: str, channel: str):
     """Returns metadata for the latest firmware for a given hw_type + channel.
     No auth required — devices call this endpoint to check for updates.
@@ -47,6 +51,14 @@ def get_latest_firmware(hw_type: str, channel: str):
     return service.get_latest(hw_type, channel)
 
 
+@router.get("/{hw_type}/{channel}/{version}/info", response_model=FirmwareMetadataResponse)
+def get_firmware_info(hw_type: str, channel: str, version: str):
+    """Returns metadata for a specific firmware version.
+    No auth required — devices call this to resolve upgrade chains.
+    """
+    return service.get_version_info(hw_type, channel, version)
+
+
 @router.get("/{hw_type}/{channel}/{version}/firmware.bin")
 def download_firmware(hw_type: str, channel: str, version: str):
     """Download the firmware binary. No auth required — devices call this directly."""