typescript

frontend/src/hooks/documents/useDocumentUploads.ts

@@ -28,6 +28,7 @@ type UploadQueueItem = {
 interface UploadResponse {
   reused?: boolean;
   document?: unknown;
+  folder?: { id?: FolderId };
 }
 
 interface ApiClient {
@@ -35,15 +36,19 @@ interface ApiClient {
   get<T = { document?: unknown }>(url: string): Promise<{ data: T }>;
 }
 
+type StatusLevel = 'success' | 'info' | 'warning' | 'error' | string;
+type NotifyApiError = (error: unknown, fallbackMessage?: string) => void;
+type SetStatusMessage = (message: string, level?: StatusLevel) => void;
+
 type DropOverlayState = {
   active: boolean;
   folderName: string;
 };
 
-type FileSystemEntryLike = FileSystemFileEntryLike | FileSystemDirectoryEntryLike;
+type FileSystemEntryLike = FileSystemEntry;
 
 type ExtendedDataTransferItem = DataTransferItem & {
-  webkitGetAsEntry?: () => FileSystemEntryLike | null;
+  webkitGetAsEntry?: () => FileSystemEntry | null;
 };
 
 interface FileSystemDirectoryReaderLike {
@@ -98,6 +103,8 @@ interface UseDocumentUploadsArgs {
   refreshCurrentFolder: () => Promise<void>;
   setLoading: (state: boolean) => void;
   shellRef: MutableRefObject<HTMLElement | null>;
+  notifyApiError?: NotifyApiError;
+  setStatusMessage?: SetStatusMessage;
 }
 
 interface UseDocumentUploadsResult {
@@ -127,6 +134,8 @@ const useDocumentUploads = ({
   refreshCurrentFolder,
   setLoading,
   shellRef,
+  notifyApiError,
+  setStatusMessage,
 }: UseDocumentUploadsArgs): UseDocumentUploadsResult => {
   const [dropOverlayState, setDropOverlayState] = useState<DropOverlayState>({
     active: false,
@@ -145,8 +154,8 @@ const useDocumentUploads = ({
 
       const formData = new FormData();
       formData.append('file', file, file.name);
-      if (targetFolderId && targetFolderId !== 'root') {
-        formData.append('folder_id', targetFolderId);
+      if (targetFolderId != null && targetFolderId !== 'root') {
+        formData.append('folder_id', String(targetFolderId));
       }
 
       try {
@@ -179,11 +188,13 @@ const useDocumentUploads = ({
           };
         }
         const message = error.response?.data?.error || `Failed to upload ${file.name}.`;
+        notifyApiError?.(error, message);
+        setStatusMessage?.(message, 'error');
         const wrapped = Object.assign(new Error(message), { response: error.response });
         throw wrapped;
       }
     },
-    [apiClient],
+    [apiClient, notifyApiError, setStatusMessage],
   );
 
   const appendQueueItems = useCallback((entries: FileEntry[], targetFolderId?: FolderId) => {
@@ -235,9 +246,13 @@ const useDocumentUploads = ({
         segments: trimmedSegments,
       };
 
-      const { data } = await apiClient.post('/folders/path', payload);
-      cache.set(cacheKey, data.folder.id);
-      return data.folder.id;
+      const { data } = await apiClient.post<{ folder?: { id?: FolderId | null } }>(
+        '/folders/path',
+        payload,
+      );
+      const resolvedId = (data?.folder?.id ?? null) as FolderId;
+      cache.set(cacheKey, resolvedId);
+      return resolvedId;
     },
     [apiClient],
   );
@@ -284,7 +299,7 @@ const useDocumentUploads = ({
       if (entry.isFile) {
         const file = await new Promise<File>((resolve, reject) => {
           try {
-            (entry as FileSystemFileEntryLike).file(resolve, reject);
+            (entry as unknown as FileSystemFileEntryLike).file(resolve, reject);
           } catch (error) {
             console.warn('[Uploads] entry.file failed', error);
             reject(error as Error);
@@ -295,7 +310,7 @@ const useDocumentUploads = ({
       }
       if (entry.isDirectory) {
         const nextAncestors = entry.name ? [...ancestors, entry.name] : [...ancestors];
-        const reader = (entry as FileSystemDirectoryEntryLike).createReader();
+        const reader = (entry as unknown as FileSystemDirectoryEntryLike).createReader();
         const entries = await readAllEntries(reader);
         for (const child of entries) {
           await walkEntry(child, nextAncestors);
@@ -506,7 +521,6 @@ const useDocumentUploads = ({
     hasFiles,
     defaultFolderName: DEFAULT_FOLDER_NAME,
     dragCounterRef,
-    dropOverlayState,
     setDropOverlayState,
   });