feat: web impl.

web/src/lib/components/maintenance/MaintenanceBackupsList.svelte

@@ -0,0 +1,120 @@
+<script lang="ts">
+  import { handleError } from '$lib/utils/handle-error';
+  import { deleteBackup, listBackups, MaintenanceAction, setMaintenanceMode } from '@immich/sdk';
+  import { Button, Card, CardBody, HStack, modalManager, Stack, Text } from '@immich/ui';
+  import { onMount } from 'svelte';
+  import { t } from 'svelte-i18n';
+  import { SvelteSet } from 'svelte/reactivity';
+
+  interface Props {
+    backups?: string[];
+    showDelete?: boolean;
+  }
+
+  let props: Props = $props();
+
+  function mapBackups(filenames: string[]) {
+    return filenames.map((filename) => {
+      const date = /(\d{4})(\d{2})(\d{2})T(\d{2})(\d{2})(\d{2})/.exec(filename);
+      const hoursAgo = date
+        ? Math.floor(
+            (+Date.now() - +new Date(`${date[1]}-${date[2]}-${date[3]}T${date[4]}:${date[5]}:${date[6]}`)) / 36e5,
+          )
+        : null;
+
+      return {
+        filename,
+        hoursAgo,
+      };
+    });
+  }
+
+  let deleting = new SvelteSet();
+  let backups = $state(mapBackups(props.backups ?? []));
+
+  onMount(async () => {
+    if (!props.backups) {
+      const result = await listBackups();
+      backups = mapBackups(result.backups);
+    }
+  });
+
+  async function restore(filename: string) {
+    const confirm = await modalManager.showDialog({
+      confirmText: 'Restore',
+      title: 'Restore Backup',
+      prompt: 'Immich will be wiped and restored from the chosen backup. A backup will be created before continuing.',
+    });
+
+    if (confirm) {
+      try {
+        await setMaintenanceMode({
+          setMaintenanceModeDto: {
+            action: MaintenanceAction.RestoreDatabase,
+            restoreBackupFilename: filename,
+          },
+        });
+      } catch (error) {
+        handleError(error, $t('admin.maintenance_start_error'));
+      }
+    }
+  }
+
+  async function remove(filename: string) {
+    const confirm = await modalManager.showDialog({
+      confirmText: 'Delete',
+      title: 'Delete Backup',
+      prompt: 'This file will be irrevocably deleted.',
+    });
+
+    if (confirm) {
+      try {
+        deleting.add(filename);
+
+        await deleteBackup({
+          filename,
+        });
+
+        backups = backups.filter((backup) => backup.filename !== filename);
+      } catch (error) {
+        handleError(error, 'failed to delete backup i18n');
+      } finally {
+        deleting.delete(filename);
+      }
+    }
+  }
+</script>
+
+<Stack gap={2} class="mt-4 text-left">
+  {#each backups as backup (backup.filename)}
+    <Card>
+      <CardBody>
+        <HStack>
+          <Stack class="flex-grow">
+            <Text>{backup.filename}</Text>
+            {#if typeof backup.hoursAgo === 'number'}
+              {#if backup.hoursAgo <= 24}
+                <Text color="info" size="small">Created {backup.hoursAgo} hours ago</Text>
+              {:else if backup.hoursAgo <= 48}
+                <Text color="info" size="small">Created 1 day ago</Text>
+              {:else}
+                <Text color="info" size="small">Created {Math.floor(backup.hoursAgo / 24)} days ago</Text>
+              {/if}
+            {/if}
+          </Stack>
+          <Button size="small" disabled={deleting.has(backup.filename)} onclick={() => restore(backup.filename)}
+            >Restore</Button
+          >
+          {#if props.showDelete}
+            <Button
+              size="small"
+              color="danger"
+              disabled={deleting.has(backup.filename)}
+              onclick={() => remove(backup.filename)}>Delete</Button
+            >
+          {/if}
+        </HStack>
+      </CardBody>
+    </Card>
+  {/each}
+</Stack>

web/src/lib/sidebars/AdminSidebar.svelte

@@ -11,6 +11,7 @@
     <NavbarItem title={$t('users')} href={AppRoute.ADMIN_USERS} icon={mdiAccountMultipleOutline} />
     <NavbarItem title={$t('jobs')} href={AppRoute.ADMIN_JOBS} icon={mdiSync} />
     <NavbarItem title={$t('settings')} href={AppRoute.ADMIN_SETTINGS} icon={mdiCog} />
+    <NavbarItem title={$t('admin.maintenance_settings')} href={AppRoute.ADMIN_MAINTENANCE} icon={mdiCog} />
     <NavbarItem title={$t('external_libraries')} href={AppRoute.ADMIN_LIBRARY_MANAGEMENT} icon={mdiBookshelf} />
     <NavbarItem title={$t('server_stats')} href={AppRoute.ADMIN_STATS} icon={mdiServer} />
   </div>

web/src/lib/stores/maintenance.store.ts

@@ -3,5 +3,5 @@ import { writable } from 'svelte/store';
 
 export const maintenanceStore = {
   auth: writable<MaintenanceAuthDto>(),
-  status: writable<MaintenanceStatusResponseDto>(),
+  status: writable<MaintenanceStatusResponseDto | undefined>(),
 };

web/src/routes/+layout.svelte

@@ -72,16 +72,17 @@
   afterNavigate(() => {
     showNavigationLoadingBar = false;
   });
+
+  const { release, serverRestarting } = websocketStore;
+
   run(() => {
-    if ($user || page.url.pathname.startsWith(AppRoute.MAINTENANCE)) {
+    if ($user || $serverRestarting || page.url.pathname.startsWith(AppRoute.MAINTENANCE)) {
       openWebsocketConnection();
     } else {
       closeWebsocketConnection();
     }
   });
 
-  const { release, serverRestarting } = websocketStore;
-
   const handleRelease = async (release?: ReleaseEvent) => {
     if (!release?.isAvailable || !$user.isAdmin) {
       return;

web/src/routes/+page.svelte

@@ -1,17 +1,39 @@
 <script lang="ts">
   import AuthPageLayout from '$lib/components/layouts/AuthPageLayout.svelte';
   import { AppRoute } from '$lib/constants';
-  import { Button, Heading } from '@immich/ui';
+  import { websocketStore } from '$lib/stores/websocket';
+  import { handleError } from '$lib/utils/handle-error';
+  import { MaintenanceAction, setMaintenanceMode } from '@immich/sdk';
+  import { Button, Heading, Stack } from '@immich/ui';
   import { t } from 'svelte-i18n';
+
+  async function switchToMaintenance() {
+    try {
+      websocketStore.serverRestarting.set({
+        isMaintenanceMode: true,
+      });
+
+      await setMaintenanceMode({
+        setMaintenanceModeDto: {
+          action: MaintenanceAction.RestoreDatabase,
+        },
+      });
+    } catch (error) {
+      handleError(error, $t('admin.maintenance_start_error'));
+    }
+  }
 </script>
 
 <AuthPageLayout>
   <div class="flex flex-col place-items-center text-center gap-12">
     <Heading size="large" color="primary" tag="h1">{$t('welcome_to_immich')}</Heading>
-    <div>
+    <Stack>
       <Button href={AppRoute.AUTH_REGISTER} size="medium" shape="round">
         <span class="px-2 font-semibold">{$t('getting_started')}</span>
       </Button>
-    </div>
+      <Button size="medium" shape="round" variant="ghost" onclick={switchToMaintenance}>
+        <span class="px-2 font-semibold">Restore from backup</span>
+      </Button>
+    </Stack>
   </div>
 </AuthPageLayout>

web/src/routes/admin/maintenance/+page.svelte

@@ -0,0 +1,62 @@
+<script lang="ts">
+  import AdminPageLayout from '$lib/components/layouts/AdminPageLayout.svelte';
+  import MaintenanceBackupsList from '$lib/components/maintenance/MaintenanceBackupsList.svelte';
+  import SettingAccordionState from '$lib/components/shared-components/settings/setting-accordion-state.svelte';
+  import SettingAccordion from '$lib/components/shared-components/settings/setting-accordion.svelte';
+  import { QueryParameter } from '$lib/constants';
+  import { handleError } from '$lib/utils/handle-error';
+  import { MaintenanceAction, setMaintenanceMode } from '@immich/sdk';
+  import { Button, HStack, Text } from '@immich/ui';
+  import { mdiProgressWrench, mdiRefresh } from '@mdi/js';
+  import { t } from 'svelte-i18n';
+  import type { PageData } from './$types';
+
+  interface Props {
+    data: PageData;
+  }
+
+  let { data }: Props = $props();
+
+  async function switchToMaintenance() {
+    try {
+      await setMaintenanceMode({
+        setMaintenanceModeDto: {
+          action: MaintenanceAction.Start,
+        },
+      });
+    } catch (error) {
+      handleError(error, $t('admin.maintenance_start_error'));
+    }
+  }
+</script>
+
+<AdminPageLayout title={data.meta.title}>
+  {#snippet buttons()}
+    <HStack gap={1}>
+      <Button
+        leadingIcon={mdiProgressWrench}
+        size="small"
+        variant="ghost"
+        color="secondary"
+        onclick={switchToMaintenance}
+      >
+        <Text class="hidden md:block">Switch to maintenance mode</Text>
+      </Button>
+    </HStack>
+  {/snippet}
+
+  <section id="setting-content" class="flex place-content-center sm:mx-4">
+    <section class="w-full pb-28 sm:w-5/6 md:w-[850px]">
+      <SettingAccordionState queryParam={QueryParameter.IS_OPEN}>
+        <SettingAccordion
+          title="Restore database backup"
+          subtitle="Rollback to an earlier database state using a backup file"
+          icon={mdiRefresh}
+          key="backups"
+        >
+          <MaintenanceBackupsList backups={data.backups} showDelete />
+        </SettingAccordion>
+      </SettingAccordionState>
+    </section>
+  </section>
+</AdminPageLayout>

web/src/routes/admin/maintenance/+page.ts

@@ -0,0 +1,17 @@
+import { authenticate } from '$lib/utils/auth';
+import { getFormatter } from '$lib/utils/i18n';
+import { listBackups } from '@immich/sdk';
+import type { PageLoad } from './$types';
+
+export const load = (async ({ url }) => {
+  await authenticate(url, { admin: true });
+  const { backups } = await listBackups();
+  const $t = await getFormatter();
+
+  return {
+    backups,
+    meta: {
+      title: $t('admin.maintenance_settings'),
+    },
+  };
+}) satisfies PageLoad;

web/src/routes/maintenance/+page.svelte

@@ -1,13 +1,14 @@
 <script lang="ts">
   import AuthPageLayout from '$lib/components/layouts/AuthPageLayout.svelte';
+  import MaintenanceBackupsList from '$lib/components/maintenance/MaintenanceBackupsList.svelte';
   import FormatMessage from '$lib/elements/FormatMessage.svelte';
   import { maintenanceStore } from '$lib/stores/maintenance.store';
   import { handleError } from '$lib/utils/handle-error';
   import { MaintenanceAction, setMaintenanceMode } from '@immich/sdk';
-  import { Button, Heading, Link } from '@immich/ui';
+  import { Button, Heading, Link, Scrollable, Text } from '@immich/ui';
   import { t } from 'svelte-i18n';
 
-  const { auth } = maintenanceStore;
+  const { auth, status } = maintenanceStore;
 
   // strip token from URL after load
   const url = new URL(location.href);
@@ -27,30 +28,66 @@
       handleError(error, $t('maintenance_end_error'));
     }
   }
+
+  let error = $derived(
+    $status?.error
+      ?.split('\n')
+      .filter((line) => !line.includes('drop cascades'))
+      .join('\n'),
+  );
 </script>
 
 <AuthPageLayout>
   <div class="flex flex-col place-items-center text-center gap-4">
-    <Heading size="large" color="primary" tag="h1">{$t('maintenance_title')}</Heading>
-    <p>
-      <FormatMessage key="maintenance_description">
-        {#snippet children({ tag, message })}
-          {#if tag === 'link'}
-            <Link href="https://docs.immich.app/administration/maintenance-mode">
-              {message}
-            </Link>
+    {#if $status?.action === MaintenanceAction.RestoreDatabase}
+      {#if $status.task}
+        <Heading size="large" color="primary" tag="h1">Restoring Database</Heading>
+        {#if $status.error}
+          <Scrollable class="max-h-[320px]">
+            <pre class="text-left"><code>{error}</code></pre>
+          </Scrollable>
+        {:else}
+          <div class="w-[240px] h-[10px] bg-gray-300 rounded-full overflow-hidden">
+            <div
+              class="h-full bg-blue-600 transition-all duration-700"
+              style="width: {($status.progress || 0) * 100}%"
+            ></div>
+          </div>
+          {#if $status.task !== 'ready'}
+            <Text>{$t(`maintenance_task_${$status.task as 'backup' | 'restore'}`)}</Text>
           {/if}
-        {/snippet}
-      </FormatMessage>
-    </p>
-    {#if $auth}
+        {/if}
+      {:else}
+        <Heading size="large" color="primary" tag="h1">Restore From Backup</Heading>
+        <Scrollable class="max-h-[320px]">
+          <MaintenanceBackupsList />
+        </Scrollable>
+        <Button onclick={end}>Cancel</Button>
+      {/if}
+    {:else}
+      <Heading size="large" color="primary" tag="h1">{$t('maintenance_title')}</Heading>
       <p>
-        {$t('maintenance_logged_in_as', {
-          values: {
-            user: $auth.username,
-          },
-        })}
+        <FormatMessage key="maintenance_description">
+          {#snippet children({ tag, message })}
+            {#if tag === 'link'}
+              <Link href="https://docs.immich.app/administration/maintenance-mode">
+                {message}
+              </Link>
+            {/if}
+          {/snippet}
+        </FormatMessage>
       </p>
+      {#if $auth}
+        <p>
+          {$t('maintenance_logged_in_as', {
+            values: {
+              user: $auth.username,
+            },
+          })}
+        </p>
+      {/if}
+    {/if}
+    {#if $auth && ($status?.action === MaintenanceAction.Start || $status?.error)}
       <Button onclick={end}>{$t('maintenance_end')}</Button>
     {/if}
   </div>