Merge pull request #3412 from Spinnich/feat/composite-hashing-archives

Composite hashing for compressed archives

Author: gantoine

backend/alembic/versions/0081_add_archive_members.py

@@ -0,0 +1,30 @@
+"""Add archive_members JSON column to rom_files
+
+Revision ID: 0081_add_archive_members
+Revises: 0080_add_chd_sha1_hash
+Create Date: 2026-05-28 00:00:00.000000
+
+"""
+
+import sqlalchemy as sa
+from alembic import op
+
+from utils.database import CustomJSON
+
+revision = "0081_add_archive_members"
+down_revision = "0080_add_chd_sha1_hash"
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    with op.batch_alter_table("rom_files", schema=None) as batch_op:
+        batch_op.add_column(
+            sa.Column("archive_members", CustomJSON(), nullable=True),
+            if_not_exists=True,
+        )
+
+
+def downgrade() -> None:
+    with op.batch_alter_table("rom_files", schema=None) as batch_op:
+        batch_op.drop_column("archive_members", if_exists=True)

backend/endpoints/feeds.py

@@ -40,7 +40,6 @@
 from handler.auth.constants import Scope
 from handler.database import db_platform_handler, db_rom_handler
 from handler.filesystem import fs_rom_handler
-from handler.filesystem.roms_handler import is_compressed_file
 from handler.metadata import meta_igdb_handler
 from handler.metadata.base_handler import (
     SONY_SERIAL_REGEX,
@@ -49,6 +48,7 @@
 )
 from handler.metadata.base_handler import UniversalPlatformSlug as UPS
 from models.rom import Rom, RomFile, RomFileCategory
+from utils.archives import is_compressed_file
 from utils.router import APIRouter
 
 

backend/endpoints/responses/rom.py

@@ -147,6 +147,14 @@ def for_user(cls, user_id: int, db_rom: Rom) -> RomUserSchema:
         return rom_user_schema_factory()
 
 
+class ArchiveMemberSchema(TypedDict):
+    name: str
+    size: int
+    crc_hash: str
+    md5_hash: str
+    sha1_hash: str
+
+
 class RomFileSchema(BaseModel):
     model_config = ConfigDict(from_attributes=True)
 
@@ -164,6 +172,7 @@ class RomFileSchema(BaseModel):
     sha1_hash: str | None
     ra_hash: str | None
     chd_sha1_hash: str | None
+    archive_members: list[ArchiveMemberSchema] | None
     category: RomFileCategory | None