Add safe archive preview and extraction workflows

src/govoplan_files/backend/schemas.py

@@ -249,6 +249,27 @@ class FileUploadResponse(BaseModel):
     files: list[FileAssetResponse]
 
 
+class ArchiveEntryResponse(BaseModel):
+    path: str
+    kind: Literal["file", "directory"]
+    size_bytes: int
+    compressed_size_bytes: int | None = None
+    encrypted: bool = False
+
+
+class ArchivePreviewResponse(BaseModel):
+    preview_token: str
+    archive_format: str
+    entries: list[ArchiveEntryResponse] = Field(default_factory=list)
+    file_count: int
+    directory_count: int
+    expanded_size_bytes: int
+    compressed_size_bytes: int
+    requires_password: bool
+    password_verified: bool
+    expires_at: str
+
+
 class FileConnectorPolicySource(BaseModel):
     scope_type: Literal["system", "tenant", "user", "group", "campaign"] = "system"
     scope_id: str | None = None