refactor: Introduce dedicated Document and Asset types and migrate codebase from DocumentLike.

frontend/src/preview/DocumentViewerLayout.tsx

@@ -5,14 +5,7 @@ import { DownloadIcon } from '../ui/icons';
 import PdfViewer from './PdfViewer';
 import { AUDIO_EXTENSIONS, VIDEO_EXTENSIONS } from '../constants/preview';
 
-interface DocumentLike {
-  id?: string;
-  title?: string;
-  mime_type?: string;
-  filename?: string;
-  original_name?: string;
-  [key: string]: unknown;
-}
+import type { Document } from '../types/documents';
 
 interface DocumentLink {
   url?: string;
@@ -36,7 +29,7 @@ interface ContentTabConfig {
 type LayoutMode = 'split' | 'stacked' | (string & {});
 
 interface DocumentViewerLayoutProps {
-  document?: DocumentLike | null;
+  document?: Document | null;
   documentLink?: DocumentLink | null;
   summaryProps?: Record<string, unknown>;
   metadataPayload?: unknown;

frontend/src/preview/DocumentViewerPanel.tsx

@@ -29,53 +29,26 @@ import DocumentViewerLayout from './DocumentViewerLayout';
 import useViewerLayoutMode from './useViewerLayoutMode';
 import { usePanelResizeBindings } from '../app/PanelManagerContext';
 import type { DocumentId, FolderId } from '../types/identifiers';
-
-interface DocumentLike {
-  id?: DocumentId;
-  title?: string;
-  mime_type?: string | null;
-  issued_at?: string | null;
-  folder_id?: FolderId | null;
-  correspondents?: Array<{ id?: string; name?: string }>;
-  current_version?: {
-    version_number?: number;
-    download?: { url?: string | null; expires_at?: number } | null;
-    mime_type?: string | null;
-    filename?: string | null;
-  } | null;
-  documentLink?: {
-    url: string;
-    alt?: string;
-    mimeType?: string | null;
-  } | null;
-  [key: string]: unknown;
-}
-
-interface AssetLike {
-  id?: string;
-  url?: string | null;
-  metadata?: Record<string, unknown> | null;
-  [key: string]: unknown;
-}
+import type { Document } from '../types/documents';
+import type { AssetLike } from '../types/assets';
 
 type SidebarMode = 'overlay' | 'inline';
 
 interface DocumentViewerPanelProps extends DocumentSummarySectionProps {
-  document: DocumentLike | null;
+  document: Document | null;
   ensureAssetUrl?: (docId: DocumentId, asset: AssetLike, options?: { force?: boolean }) => Promise<unknown>;
-  getDocumentAsset?: (doc: DocumentLike | null, type: string) => AssetLike | null;
-  ensurePreviewData?: (docId: DocumentId, options?: { signal?: AbortSignal }) => Promise<DocumentLike | null>;
+  getDocumentAsset?: (doc: Document | null, type: string) => AssetLike | null;
+  ensurePreviewData?: (docId: DocumentId, options?: { signal?: AbortSignal }) => Promise<Document | null>;
   notifyApiError?: (error: unknown, fallbackMessage?: string) => void;
   sidebarToggle?: ReactNode;
   onClosePanel?: () => void;
-  resolveFolderPath?: (doc: DocumentLike | null) => Array<{ id?: string; name?: string }>;
+  resolveFolderPath?: (doc: Document | null) => Array<{ id?: string; name?: string }>;
   variant?: 'viewer' | 'sidebar';
   onCollapsePanel?: () => void;
   onMaximizePanel?: (args: { documentIds: Array<string> }) => void;
   sidebarMode?: SidebarMode;
 }
 
-
 export const createDocumentViewerHeaderActions = ({
   document,
   actionState,