feat: Refactor device management functions to use Result type for error handling

src/apps/main/background-processes/backups/BackupConfiguration/BackupConfiguration.ts

@@ -33,7 +33,8 @@ export class BackupConfiguration {
     const { error, data } = await DeviceModule.getOrCreateDevice();
     if (error) return [];
 
-    const enabledBackupEntries = await DeviceModule.getBackupsFromDevice(data, true);
+    const { error: backupsError, data: enabledBackupEntries } = await DeviceModule.getBackupsFromDevice(data, true);
+    if (backupsError || !enabledBackupEntries) return [];
 
     return this.map(enabledBackupEntries, data.bucket);
   }

src/apps/main/interface.d.ts

@@ -36,7 +36,7 @@ export interface IElectronAPI {
 
   getOrCreateDevice: () => Promise<Result<Device, Error>>;
 
-  getBackupsFromDevice: (device: Device, isCurrent?: boolean) => Promise<Array<BackupInfo>>;
+  getBackupsFromDevice: (device: Device, isCurrent?: boolean) => Promise<Result<Array<BackupInfo>, Error>>;
 
   addBackup: () => Promise<Result<BackupInfo, Error>>;
 
@@ -62,7 +62,7 @@ export interface IElectronAPI {
 
   abortDownloadBackups: (deviceId: string) => void;
 
-  renameDevice: (deviceName: string) => Promise<Device>;
+  renameDevice: (deviceName: string) => Promise<Result<Device, Error>>;
   devices: {
     getDevices: () => Promise<Array<Device>>;
   };

src/apps/main/preload.d.ts

@@ -100,17 +100,26 @@ declare interface Window {
 
     path: typeof import('path');
 
-    getOrCreateDevice: typeof import('../../backend/features/device/device.module').DeviceModule.getOrCreateDevice;
+    getOrCreateDevice: () => Promise<
+      import('../../context/shared/domain/Result').Result<import('../main/device/service').Device, Error>
+    >;
 
-    renameDevice: typeof import('../../backend/features/device/device.module').DeviceModule.renameDevice;
+    renameDevice: (
+      deviceName: string,
+    ) => Promise<import('../../context/shared/domain/Result').Result<import('../main/device/service').Device, Error>>;
 
     devices: {
       getDevices: () => Promise<Array<Device>>;
     };
 
     onDeviceCreated(func: (value: Device) => void): () => void;
 
-    getBackupsFromDevice: typeof import('../../backend/features/device/device.module').DeviceModule.getBackupsFromDevice;
+    getBackupsFromDevice: (
+      device: import('../main/device/service').Device,
+      isCurrent?: boolean,
+    ) => Promise<
+      import('../../context/shared/domain/Result').Result<import('../backups/BackupInfo').BackupInfo[], Error>
+    >;
 
     addBackup: typeof import('../../backend/features/backup/add-backup').addBackup;
 

src/apps/renderer/context/DeviceContext.tsx

@@ -58,18 +58,15 @@
   const deviceRename = async (deviceName: string) => {
     setDeviceState({ status: 'LOADING' });
 
-    try {
-      const updatedDevice = await window.electron.renameDevice(deviceName);
-      setDeviceState({ status: 'SUCCESS', device: updatedDevice });
-      setCurrent(updatedDevice);
-      setSelected(updatedDevice);
-    } catch (err) {
-      window.electron.logger.error({
-        msg: '[RENDERER] Failed to rename device',
-        error: err,
-      });
+    const { error, data: updatedDevice } = await window.electron.renameDevice(deviceName);
+    if (error || !updatedDevice) {
       setDeviceState({ status: 'ERROR' });
+      return;
     }
+
+    setDeviceState({ status: 'SUCCESS', device: updatedDevice });
+    setCurrent(updatedDevice);
+    setSelected(updatedDevice);
   };
 
   return (

src/apps/renderer/hooks/backups/useBackups.tsx

@@ -23,10 +23,17 @@
   const [backups, setBackups] = useState<Array<BackupInfo>>([]);
   const [hasExistingBackups, setHasExistingBackups] = useState(false);
 
-  async function fetchBackups(): Promise<void> {
-    if (!selected) return;
-    const backups = await window.electron.getBackupsFromDevice(selected, selected === current);
-    setBackups(backups);
+  async function fetchBackups(): Promise<boolean> {
+    if (!selected) return true;
+
+    const { error, data } = await window.electron.getBackupsFromDevice(selected, selected === current);
+    if (error || !data) {
+      setBackups([]);
+      return false;
+    }
+
+    setBackups(data);
+    return true;
   }
 
   const validateIfBackupExists = async () => {
@@ -38,13 +45,14 @@
     setBackupsState('LOADING');
     setBackups([]);
 
-    try {
-      await fetchBackups();
-      setBackupsState('SUCCESS');
-    } catch {
+    const isLoaded = await fetchBackups();
+    if (!isLoaded) {
       setBackupsState('ERROR');
       setBackups([]);
+      return;
     }
+
+    setBackupsState('SUCCESS');
   }
 
   useEffect(() => {

src/backend/features/backup/change-backup-path.test.ts

@@ -67,7 +67,7 @@ describe('change-backup-path', () => {
     mockedConfigStoreGet.mockReturnValue(backupList);
     mockedGetBackupFolderUuid.mockResolvedValue({ data: 'remote-folder-uuid' });
     mockedRenameFolder.mockResolvedValue({ data: {} });
-    mockedMigrateBackupEntryIfNeeded.mockResolvedValue(migratedBackup);
+    mockedMigrateBackupEntryIfNeeded.mockResolvedValue({ data: migratedBackup });
 
     const result = await changeBackupPath({ currentPath, newPath });
 

src/backend/features/backup/change-backup-path.ts

@@ -42,11 +42,13 @@ export async function changeBackupPath({ currentPath, newPath }: Props): Promise
 
     delete backupsList[currentPath];
 
-    const migratedExistingBackup = await migrateBackupEntryIfNeeded({
+    const { error, data } = await migrateBackupEntryIfNeeded({
       pathname: newPath,
       backup: existingBackup,
     });
-    backupsList[newPath] = migratedExistingBackup;
+    if (error) return { error };
+
+    backupsList[newPath] = data;
 
     configStore.set('backupList', backupsList);
 

src/backend/features/backup/delete-device-backups.test.ts

@@ -36,8 +36,8 @@ describe('delete-device-backups', () => {
       },
     ];
 
-    getBackupsFromDeviceMock.mockResolvedValue(backups);
-    deleteBackupMock.mockResolvedValue(undefined);
+    getBackupsFromDeviceMock.mockResolvedValue({ data: backups });
+    deleteBackupMock.mockResolvedValue({ data: undefined });
     getBackupFolderTreeSnapshotMock.mockResolvedValue({
       data: {
         tree: {
@@ -68,8 +68,8 @@ describe('delete-device-backups', () => {
       },
     ];
 
-    getBackupsFromDeviceMock.mockResolvedValue(backups);
-    deleteBackupMock.mockResolvedValue(undefined);
+    getBackupsFromDeviceMock.mockResolvedValue({ data: backups });
+    deleteBackupMock.mockResolvedValue({ data: undefined });
     getBackupFolderTreeSnapshotMock.mockResolvedValue({
       data: { tree: { children: [{ id: 10, uuid: 'folder-uuid-1' }] } },
     } as never);

src/backend/features/backup/delete-device-backups.ts

@@ -11,7 +11,12 @@ type Props = {
 };
 
 export async function deleteDeviceBackups({ device, isCurrent }: Props) {
-  const backups = await DeviceModule.getBackupsFromDevice(device, isCurrent);
+  const { error: getBackupsError, data: backups } = await DeviceModule.getBackupsFromDevice(device, isCurrent);
+  if (getBackupsError) {
+    logger.error({ tag: 'BACKUPS', msg: 'Error fetching backups from device', error: getBackupsError });
+    return;
+  }
+
   logger.debug({ tag: 'BACKUPS', msg: '[BACKUPS] Deleting backups from device', count: backups.length });
   logger.debug({ tag: 'BACKUPS', msg: '[BACKUPS] Backups details', backups });
 

src/backend/features/backup/download-backup.test.ts

@@ -53,6 +53,7 @@ describe('download-backup', () => {
   it('should download backup and broadcast progress when not aborted', async () => {
     downloadDeviceBackupZipMock.mockImplementation(async ({ updateProgress }) => {
       updateProgress(33);
+      return { data: true };
     });
 
     await downloadBackup({ device, pathname });
@@ -86,6 +87,7 @@ describe('download-backup', () => {
       const abortListener = ipcMainOnMock.mock.calls[0]?.[1];
       abortListener?.({} as never, device.uuid);
       updateProgress(90);
+      return { data: true };
     });
 
     await downloadBackup({ device, pathname });
@@ -98,6 +100,7 @@ describe('download-backup', () => {
       const abortListener = ipcMainOnMock.mock.calls[0]?.[1];
       abortListener?.({} as never, 'other-device-uuid');
       updateProgress(12);
+      return { data: true };
     });
 
     await downloadBackup({ device, pathname });

src/backend/features/device/createAndSetupNewDevice.test.ts

@@ -0,0 +1,103 @@
+import { BrowserWindow } from 'electron';
+import { broadcastToWindows } from '../../../apps/main/windows';
+import { DependencyInjectionUserProvider } from '../../../apps/shared/dependency-injection/DependencyInjectionUserProvider';
+import { createNewDevice } from './createNewDevice';
+import { createAndSetupNewDevice } from './createAndSetupNewDevice';
+import { getDeviceIdentifier } from './getDeviceIdentifier';
+
+vi.mock('electron', async (importOriginal) => {
+  const actual = await importOriginal<typeof import('electron')>();
+
+  return {
+    ...actual,
+    app: {
+      ...actual.app,
+      getPath: vi.fn().mockReturnValue('/tmp/backups'),
+    },
+    ipcMain: {
+      ...actual.ipcMain,
+      on: vi.fn(),
+      handle: vi.fn(),
+      removeHandler: vi.fn(),
+    },
+    BrowserWindow: {
+      ...actual.BrowserWindow,
+      getAllWindows: vi.fn(),
+    },
+  };
+});
+vi.mock('./getDeviceIdentifier');
+vi.mock('./createNewDevice');
+vi.mock('../../../apps/main/windows', () => ({
+  broadcastToWindows: vi.fn(),
+}));
+vi.mock('../../../apps/shared/dependency-injection/DependencyInjectionUserProvider', () => ({
+  DependencyInjectionUserProvider: { get: vi.fn(), updateUser: vi.fn() },
+}));
+
+describe('createAndSetupNewDevice', () => {
+  const mockedGetDeviceIdentifier = vi.mocked(getDeviceIdentifier);
+  const mockedCreateNewDevice = vi.mocked(createNewDevice);
+  const mockedBroadcastToWindows = vi.mocked(broadcastToWindows);
+  const mockedBrowserWindowGetAllWindows = vi.mocked(BrowserWindow.getAllWindows);
+  const mockedUserProviderGet = vi.mocked(DependencyInjectionUserProvider.get);
+  const mockedUserProviderUpdate = vi.mocked(DependencyInjectionUserProvider.updateUser);
+
+  beforeEach(() => {
+    vi.clearAllMocks();
+    mockedUserProviderGet.mockReturnValue({ backupsBucket: '' } as never);
+    mockedBrowserWindowGetAllWindows.mockReturnValue([] as never);
+  });
+
+  it('should return only error when the device identifier is unavailable', async () => {
+    const error = new Error('Missing device identifier');
+    mockedGetDeviceIdentifier.mockReturnValue({ error });
+
+    const result = await createAndSetupNewDevice();
+
+    expect(result).toStrictEqual({ error });
+    expect(mockedCreateNewDevice).not.toHaveBeenCalled();
+    expect(mockedBroadcastToWindows).not.toHaveBeenCalled();
+  });
+
+  it('should return only error when the device creation fails', async () => {
+    const error = new Error('Create device failed');
+    mockedGetDeviceIdentifier.mockReturnValue({
+      data: { key: 'key', platform: 'linux', hostname: 'host' },
+    });
+    mockedCreateNewDevice.mockResolvedValue({ error });
+
+    const result = await createAndSetupNewDevice();
+
+    expect(result).toStrictEqual({ error });
+    expect(mockedBroadcastToWindows).not.toHaveBeenCalled();
+    expect(mockedUserProviderUpdate).not.toHaveBeenCalled();
+  });
+
+  it('should update the user and notify windows when the device is created', async () => {
+    const user = { backupsBucket: '' };
+    const send = vi.fn();
+    const device = {
+      id: 1,
+      uuid: 'device-uuid',
+      name: 'Laptop',
+      bucket: 'bucket-1',
+      removed: false,
+      hasBackups: true,
+    };
+    mockedUserProviderGet.mockReturnValue(user as never);
+    mockedBrowserWindowGetAllWindows.mockReturnValue([{ webContents: { send } }] as never);
+    mockedGetDeviceIdentifier.mockReturnValue({
+      data: { key: 'key', platform: 'linux', hostname: 'host' },
+    });
+    mockedCreateNewDevice.mockResolvedValue({ data: device });
+
+    const result = await createAndSetupNewDevice();
+
+    expect(result).toStrictEqual({ data: device });
+    expect(user.backupsBucket).toBe('bucket-1');
+    expect(mockedUserProviderUpdate).toHaveBeenCalledWith(user);
+    expect(send).toHaveBeenCalledWith('reinitialize-backups');
+    expect(mockedBroadcastToWindows).toHaveBeenCalledWith('device-created', device);
+  });
+});

src/backend/features/device/createAndSetupNewDevice.ts

@@ -9,17 +9,16 @@ export async function createAndSetupNewDevice() {
   const { error, data: deviceIdentifier } = getDeviceIdentifier();
   if (error) return { error };
 
-  const createNewDeviceEither = await createNewDevice(deviceIdentifier);
-  if (createNewDeviceEither.isLeft()) {
+  const { error: createDeviceError, data: device } = await createNewDevice(deviceIdentifier);
+  if (createDeviceError) {
     logger.error({
       tag: 'BACKUPS',
       msg: '[DEVICE] Error creating new device',
-      error: createNewDeviceEither.getLeft(),
+      error: createDeviceError,
     });
-    return { error: createNewDeviceEither.getLeft() };
+    return { error: createDeviceError };
   }
 
-  const device = createNewDeviceEither.getRight();
   const user = DependencyInjectionUserProvider.get();
   user.backupsBucket = device.bucket;
   DependencyInjectionUserProvider.updateUser(user);