@lapis-notes/history 0.1.4 → 0.2.0

package/dist/repository/components/backup/SyncConflictEditor.svelte

@@ -0,0 +1,158 @@
+<script lang="ts">
+  import { onMount, untrack } from "svelte";
+  import { MediaQuery } from "svelte/reactivity";
+  import { Button } from "@lapismd/design-core/shadcn/button";
+  import RepositoryConflictSurface from "../conflicts/RepositoryConflictSurface.svelte";
+  import RepositoryConflictText from "../conflicts/RepositoryConflictText.svelte";
+  import RepositorySkeleton from "../RepositorySkeleton.svelte";
+  import type { SyncController } from "../../controllers/sync-controller.js";
+  import type { SyncState } from "../../controllers/sync.js";
+  let {
+    controller,
+    open,
+    onClose,
+  }: { controller: SyncController; open: boolean; onClose(): void } = $props();
+  let snapshot = $state<SyncState>({
+    busy: false,
+    phase: "ready",
+    enabled: true,
+    recovery: false,
+  });
+  let active = $state("");
+  let browserOpen = $state(true);
+  let draft = $state("");
+  let seed = $state("");
+  let resolved = $state(false);
+  let loaded = "";
+  let requested = $state("");
+  const compact = new MediaQuery("(max-width: 700px)");
+  const files = $derived(
+    snapshot.proposal?.conflicts.map((path) => ({ path })) ?? [],
+  );
+  const detail = $derived(
+    snapshot.conflict?.path === active ? snapshot.conflict : undefined,
+  );
+  const text = $derived(
+    detail?.terms.length === 3 &&
+      detail.terms.every(
+        (term) =>
+          term.kind === "text" &&
+          term.executable === detail.terms[0].executable,
+      ),
+  );
+  onMount(() => controller.subscribe((next) => (snapshot = next)));
+  $effect(() => {
+    if (!open || snapshot.busy || !files.length) return;
+    const path = files.some((file) => file.path === active)
+      ? active
+      : files[0].path;
+    if (active !== path) active = path;
+    if (detail) {
+      const key = `${snapshot.proposal?.candidate?.commit}:${path}`;
+      if (loaded !== key) {
+        loaded = key;
+        draft = detail.terms[1]?.text ?? "";
+        seed = draft;
+        resolved = false;
+      }
+    } else {
+      const key = `${snapshot.proposal?.candidate?.commit}:${path}`;
+      if (requested !== key) {
+        requested = key;
+        untrack(() => void controller.inspect(path));
+      }
+    }
+  });
+  $effect(() => {
+    if (compact.current) browserOpen = false;
+  });
+  $effect(() => {
+    if (open && !snapshot.busy && !files.length) untrack(onClose);
+  });
+</script>
+
+<RepositoryConflictSurface
+  {open}
+  label="Resolve backup synchronization conflicts"
+  busy={snapshot.busy}
+  locked={snapshot.busy}
+  bind:browserOpen
+  compact={compact.current}
+  {files}
+  activePath={active}
+  onSelect={(path) => {
+    active = path;
+    if (compact.current) browserOpen = false;
+  }}
+  {onClose}
+>
+  {#snippet actions()}
+    {#if detail}<Button
+        size="sm"
+        disabled={snapshot.busy || !text || !resolved}
+        onclick={() =>
+          controller.resolve(active, {
+            kind: "text",
+            text: draft,
+            executable: detail?.terms[0].executable ?? false,
+          })}>Save resolution</Button
+      >
+      <Button
+        variant="outline"
+        size="sm"
+        disabled={snapshot.busy}
+        onclick={() => controller.resolve(active, { kind: "delete" })}
+        >Delete file</Button
+      >{/if}
+  {/snippet}
+  {#if !detail}
+    {#if snapshot.busy}<RepositorySkeleton
+        kind="conflicts"
+        label="Loading synchronization conflict"
+      />
+    {:else}<section class="unsupported">
+        <p>Conflict details are unavailable.</p>
+        <Button
+          variant="outline"
+          size="sm"
+          onclick={() => controller.inspect(active)}
+          >Retry conflict details</Button
+        >
+      </section>{/if}
+  {:else if text}<RepositoryConflictText
+      path={active}
+      left={detail.terms[0].text ?? ""}
+      base={seed}
+      right={detail.terms[2].text ?? ""}
+      editable
+      onResolvedChange={({ content, resolved: complete }) => {
+        draft = content;
+        resolved = complete;
+      }}
+    />
+  {:else}<section class="unsupported">
+      <p>Choose a retained version for this file.</p>
+      {#each detail.terms.filter((term) => term.role === "add") as term}<Button
+          variant="outline"
+          size="sm"
+          disabled={snapshot.busy || term.kind === "unsupported"}
+          onclick={() =>
+            controller.resolve(active, { kind: "term", id: term.id })}
+          >Use {term.id === 0 ? "local" : "remote"} version ({term.kind})</Button
+        >{/each}
+    </section>{/if}
+</RepositoryConflictSurface>
+
+<style>
+  .unsupported {
+    padding: 1rem;
+    display: flex;
+    flex-wrap: wrap;
+    gap: 0.5rem;
+    align-items: center;
+  }
+  p {
+    flex-basis: 100%;
+    font-size: 0.8rem;
+  }
+</style>

package/dist/repository/components/backup/SyncConflictEditor.svelte.d.ts

@@ -0,0 +1,9 @@
+import type { SyncController } from "../../controllers/sync-controller.js";
+type $$ComponentProps = {
+    controller: SyncController;
+    open: boolean;
+    onClose(): void;
+};
+declare const SyncConflictEditor: import("svelte").Component<$$ComponentProps, {}, "">;
+type SyncConflictEditor = ReturnType<typeof SyncConflictEditor>;
+export default SyncConflictEditor;

package/dist/repository/components/backup/SyncSettings.svelte

@@ -0,0 +1,97 @@
+<script lang="ts">
+  import { onMount } from "svelte";
+  import { Button } from "@lapismd/design-core/shadcn/button";
+  import { Switch } from "@lapismd/design-core/shadcn/switch";
+  import * as Field from "@lapismd/design-core/shadcn/field";
+  import BackupCard from "./BackupCard.svelte";
+  import RefreshCw from "@lucide/svelte/icons/refresh-cw";
+  import GitMerge from "@lucide/svelte/icons/git-merge";
+  import type { SyncController } from "../../controllers/sync-controller.js";
+  import type { SyncState } from "../../controllers/sync.js";
+  let {
+    controller,
+    setEnabled,
+    onReview,
+  }: {
+    controller: SyncController;
+    setEnabled(enabled: boolean): Promise<void>;
+    onReview(): void;
+  } = $props();
+  let snapshot = $state<SyncState>({
+    busy: false,
+    phase: "ready",
+    enabled: true,
+    recovery: false,
+  });
+  onMount(() => controller.subscribe((next) => (snapshot = next)));
+  const descriptions = {
+    ready:
+      "Local history is safe. Connected backups synchronize in the background.",
+    fetching: "Fetching and merging remote history…",
+    applying: "Applying merged files safely…",
+    publishing: "Publishing the selected backup branch…",
+    conflicts:
+      "Local and remote edits need review. Current files have been preserved.",
+    attention:
+      "Synchronization needs attention. Your local history remains available.",
+    paused:
+      "Remote synchronization is paused. Local history remains independent.",
+  };
+</script>
+
+<BackupCard
+  title="Automatic synchronization"
+  Icon={RefreshCw}
+  description={descriptions[snapshot.phase]}
+>
+  <div class="sync-actions">
+    <Field.Field orientation="horizontal" data-disabled={snapshot.busy}
+      ><Switch
+        id="automatic-vault-sync"
+        checked={snapshot.enabled}
+        disabled={snapshot.busy}
+        onCheckedChange={(checked) => void setEnabled(checked)}
+      /><Field.Label for="automatic-vault-sync"
+        >Synchronize the connected backup automatically</Field.Label
+      ></Field.Field
+    >
+    <Button
+      variant="outline"
+      size="sm"
+      disabled={snapshot.busy || !snapshot.enabled}
+      onclick={() => controller.run()}
+      ><RefreshCw data-icon="inline-start" />Sync now</Button
+    >
+    {#if snapshot.proposal?.conflicts.length}<Button
+        variant="outline"
+        size="sm"
+        disabled={snapshot.busy}
+        onclick={onReview}
+        ><GitMerge data-icon="inline-start" />Review {snapshot.proposal
+          .conflicts.length} conflicts</Button
+      >{/if}
+    {#if snapshot.recovery}<Button
+        variant="outline"
+        size="sm"
+        disabled={snapshot.busy}
+        onclick={() => controller.keepCurrent()}>Keep current files</Button
+      >{/if}
+  </div>
+  {#if snapshot.lastSuccess}<p>
+      Last synchronized {new Date(snapshot.lastSuccess).toLocaleTimeString()}
+    </p>{/if}
+</BackupCard>
+
+<style>
+  .sync-actions {
+    display: flex;
+    flex-wrap: wrap;
+    align-items: center;
+    gap: 0.75rem;
+  }
+  p {
+    color: var(--muted-foreground);
+    font-size: 0.75rem;
+    margin: 0.75rem 0 0;
+  }
+</style>

package/dist/repository/components/backup/SyncSettings.svelte.d.ts

@@ -0,0 +1,9 @@
+import type { SyncController } from "../../controllers/sync-controller.js";
+type $$ComponentProps = {
+    controller: SyncController;
+    setEnabled(enabled: boolean): Promise<void>;
+    onReview(): void;
+};
+declare const SyncSettings: import("svelte").Component<$$ComponentProps, {}, "">;
+type SyncSettings = ReturnType<typeof SyncSettings>;
+export default SyncSettings;

package/dist/repository/components/backup/adoption-settings.d.ts

@@ -0,0 +1,7 @@
+import type { RepositoryPlugin } from "../repository-plugin.js";
+import type { AdoptionService } from "../../controllers/adoption.js";
+import { AdoptionController } from "../../controllers/adoption-controller.js";
+export declare function adoptionSettings(plugin: RepositoryPlugin, service?: AdoptionService): {
+    controller: AdoptionController;
+    close(): Promise<void>;
+} | undefined;

package/dist/repository/components/backup/adoption-settings.js

@@ -0,0 +1,42 @@
+import { adoptionRequest } from "../../controllers/adoption.js";
+import { AdoptionController } from "../../controllers/adoption-controller.js";
+import { updateRepositoryData } from "../../controllers/plugin-data.js";
+import { BackgroundWork } from "../../controllers/background-work.js";
+export function adoptionSettings(plugin, service) {
+    if (!service)
+        return;
+    const controller = new AdoptionController(service, {
+        async load() {
+            const saved = (await plugin.loadData())?.historyAdoption;
+            return saved == null ? undefined : adoptionRequest(saved);
+        },
+        async save(request) {
+            await updateRepositoryData(plugin, {
+                historyAdoption: request ?? null,
+            });
+        },
+    }, plugin.feedback("Import original history", "repository-history:adoption"), async (action) => {
+        let phase;
+        const stop = plugin.backup?.controller.subscribe((state) => {
+            phase = state.phase;
+        });
+        stop?.();
+        if (!plugin.backup || phase === "closed")
+            throw new Error("Enable automatic local history before importing original history");
+        return plugin.app.fileEditingSessions.guard(undefined, async () => {
+            await plugin.backup?.sync?.controller.drained();
+            return action();
+        });
+    });
+    const progress = new BackgroundWork(plugin.app.notifications, plugin.id).follow("Importing original history", {
+        subscribe: (listener) => controller.subscribeActivity(listener),
+    });
+    return {
+        controller,
+        async close() {
+            controller.close();
+            await controller.drained();
+            progress();
+        },
+    };
+}

package/dist/repository/components/backup/backup-settings.d.ts

@@ -0,0 +1,35 @@
+import type { WorkspaceCustomSetting } from "@lapis-notes/api";
+import type { ComponentProps } from "svelte";
+import { ForgeController } from "../../controllers/forge-controller.js";
+import type { RepositoryServices } from "../../controllers/history-reader.js";
+import { RemoteController } from "../../controllers/remote-controller.js";
+import type { RepositoryPlugin } from "../repository-plugin.js";
+import type BackupSettings from "./BackupSettings.svelte";
+export declare const BACKUP_SETTINGS = "repository-history.remoteBackup";
+export type BackupSettingsFieldDefinition = WorkspaceCustomSetting & {
+    openPanel(): BackupSettingsPanel;
+};
+export type BackupSettingsPanel = {
+    props: ComponentProps<typeof BackupSettings>;
+    close(): Promise<void>;
+    report(error: unknown): void;
+};
+export declare function openBackupSettings(plugin: RepositoryPlugin): void;
+/** Each visible settings panel owns transient accounts; durable work stays plugin-owned. */
+export declare function createBackupSettings(plugin: RepositoryPlugin, services: RepositoryServices): {
+    field: BackupSettingsFieldDefinition;
+    openPanel: () => {
+        props: {
+            controller: ForgeController;
+            remote: RemoteController | undefined;
+            restore: import("../../controllers/restore.js").RestoreController | undefined;
+            storage: import("../../controllers/storage-controller.js").StorageController | undefined;
+            adoption: import("../../controllers/adoption-controller.js").AdoptionController | undefined;
+            sync: import("../../controllers/sync-controller.js").SyncController | undefined;
+            setSyncEnabled: (enabled: boolean) => Promise<void>;
+        };
+        close(): Promise<void>;
+        report: (error: unknown) => void;
+    };
+    close(): Promise<void>;
+} | undefined;

package/dist/repository/components/backup/backup-settings.js

@@ -0,0 +1,96 @@
+import { getWorkspaceHostBinding } from "@lapis-notes/api/workspace-host";
+import { ForgeController } from "../../controllers/forge-controller.js";
+import { RemoteController } from "../../controllers/remote-controller.js";
+import { BackgroundWork } from "../../controllers/background-work.js";
+import BackupSettingsField from "./BackupSettingsField.svelte";
+import { createRemoteRestore } from "./remote-restore.js";
+import { adoptionSettings } from "./adoption-settings.js";
+import { storageSettings } from "./storage-settings.js";
+export const BACKUP_SETTINGS = "repository-history.remoteBackup";
+export function openBackupSettings(plugin) {
+    getWorkspaceHostBinding(plugin.app.workspace).controller.settings.open({
+        sectionId: "repository-history",
+        fieldId: BACKUP_SETTINGS,
+    });
+}
+/** Each visible settings panel owns transient accounts; durable work stays plugin-owned. */
+export function createBackupSettings(plugin, services) {
+    if (!services.forges)
+        return;
+    const sessions = new Set();
+    const storage = storageSettings(plugin, services.storage);
+    const adoption = adoptionSettings(plugin, services.adoption);
+    const activity = new BackgroundWork(plugin.app.notifications, plugin.id);
+    const forges = services.forges;
+    function openPanel() {
+        const controller = new ForgeController(forges, plugin.feedback("Forge accounts", "repository-history:forge-accounts"));
+        const progress = activity.follow("Connecting forge accounts", {
+            subscribe: (listener) => controller.subscribeActivity(listener),
+        });
+        const remote = services.remote
+            ? new RemoteController(services.remote, plugin.feedback("Remote backup", "repository-history:remote"))
+            : undefined;
+        const restore = services.remote
+            ? createRemoteRestore(plugin, services.remote)
+            : undefined;
+        const remoteProgress = remote &&
+            activity.follow("Remote vault backup", {
+                subscribe: (listener) => remote.subscribeActivity(listener),
+            });
+        let closing;
+        const panel = {
+            props: {
+                controller,
+                remote,
+                restore,
+                storage: storage?.controller,
+                adoption: adoption?.controller,
+                sync: plugin.backup?.sync?.controller,
+                setSyncEnabled: (enabled) => plugin
+                    .backup.sync.setEnabled(enabled)
+                    .catch((error) => plugin.report(error)),
+            },
+            close() {
+                return (closing ??= (async () => {
+                    remote?.close();
+                    restore?.close();
+                    await controller.close();
+                    // Fence replies now; account networking must not hold vault closure.
+                    // Progress remains owned until the actual native operations drain.
+                    void Promise.allSettled([
+                        controller.drained(),
+                        remote?.drained(),
+                    ]).then(() => {
+                        progress();
+                        remoteProgress?.();
+                        sessions.delete(panel);
+                    });
+                })());
+            },
+            report: (error) => plugin.report(error),
+        };
+        sessions.add(panel);
+        return panel;
+    }
+    plugin.addCommand({
+        id: "open-backup-settings",
+        name: "Open Repository Backup Settings",
+        callback: () => openBackupSettings(plugin),
+    });
+    const field = {
+        id: BACKUP_SETTINGS,
+        type: "custom",
+        title: "Backup and synchronisation",
+        presentation: "full-width",
+        component: BackupSettingsField,
+        openPanel,
+    };
+    return {
+        field,
+        openPanel,
+        async close() {
+            await Promise.allSettled([...sessions].map((panel) => panel.close()));
+            await Promise.all([storage?.close(), adoption?.close()]);
+        },
+    };
+}

package/dist/repository/components/backup/forge-icons.d.ts

@@ -0,0 +1,10 @@
+export declare const forgeIcons: {
+    readonly github: {
+        readonly name: "GitHub";
+        readonly path: "M12 .297c-6.63 0-12 5.373-12 12 0 5.303 3.438 9.8 8.205 11.385.6.113.82-.258.82-.577 0-.285-.01-1.04-.015-2.04-3.338.724-4.042-1.61-4.042-1.61C4.422 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.729.084-.729 1.205.084 1.838 1.236 1.838 1.236 1.07 1.835 2.809 1.305 3.495.998.108-.776.417-1.305.76-1.605-2.665-.3-5.466-1.332-5.466-5.93 0-1.31.465-2.38 1.235-3.22-.135-.303-.54-1.523.105-3.176 0 0 1.005-.322 3.3 1.23.96-.267 1.98-.399 3-.405 1.02.006 2.04.138 3 .405 2.28-1.552 3.285-1.23 3.285-1.23.645 1.653.24 2.873.12 3.176.765.84 1.23 1.91 1.23 3.22 0 4.61-2.805 5.625-5.475 5.92.42.36.81 1.096.81 2.22 0 1.606-.015 2.896-.015 3.286 0 .315.21.69.825.57C20.565 22.092 24 17.592 24 12.297c0-6.627-5.373-12-12-12";
+    };
+    readonly forgejo: {
+        readonly name: "Forgejo";
+        readonly path: "M16.7773 0c1.6018 0 2.9004 1.2986 2.9004 2.9005s-1.2986 2.9004-2.9004 2.9004c-1.0854 0-2.0315-.596-2.5288-1.4787H12.91c-2.3322 0-4.2272 1.8718-4.2649 4.195l-.0007 2.1175a7.0759 7.0759 0 0 1 4.148-1.4205l.1176-.001 1.3385.0002c.4973-.8827 1.4434-1.4788 2.5288-1.4788 1.6018 0 2.9004 1.2986 2.9004 2.9005s-1.2986 2.9004-2.9004 2.9004c-1.0854 0-2.0315-.596-2.5288-1.4787H12.91c-2.3322 0-4.2272 1.8718-4.2649 4.195l-.0007 2.319c.8827.4973 1.4788 1.4434 1.4788 2.5287 0 1.602-1.2986 2.9005-2.9005 2.9005-1.6018 0-2.9004-1.2986-2.9004-2.9005 0-1.0853.596-2.0314 1.4788-2.5287l-.0002-9.9831c0-3.887 3.1195-7.0453 6.9915-7.108l.1176-.001h1.3385C14.7458.5962 15.692 0 16.7773 0ZM7.2227 19.9052c-.6596 0-1.1943.5347-1.1943 1.1943s.5347 1.1943 1.1943 1.1943 1.1944-.5347 1.1944-1.1943-.5348-1.1943-1.1944-1.1943Zm9.5546-10.4644c-.6596 0-1.1944.5347-1.1944 1.1943s.5348 1.1943 1.1944 1.1943c.6596 0 1.1943-.5347 1.1943-1.1943s-.5347-1.1943-1.1943-1.1943Zm0-7.7346c-.6596 0-1.1944.5347-1.1944 1.1943s.5348 1.1943 1.1944 1.1943c.6596 0 1.1943-.5347 1.1943-1.1943s-.5347-1.1943-1.1943-1.1943Z";
+    };
+};

package/dist/repository/components/backup/forge-icons.js

@@ -0,0 +1,11 @@
+// Copied from jj-store site-icons.ts; Simple Icons, CC0-1.0. See docs/provenance.json.
+export const forgeIcons = {
+    github: {
+        name: "GitHub",
+        path: "M12 .297c-6.63 0-12 5.373-12 12 0 5.303 3.438 9.8 8.205 11.385.6.113.82-.258.82-.577 0-.285-.01-1.04-.015-2.04-3.338.724-4.042-1.61-4.042-1.61C4.422 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.729.084-.729 1.205.084 1.838 1.236 1.838 1.236 1.07 1.835 2.809 1.305 3.495.998.108-.776.417-1.305.76-1.605-2.665-.3-5.466-1.332-5.466-5.93 0-1.31.465-2.38 1.235-3.22-.135-.303-.54-1.523.105-3.176 0 0 1.005-.322 3.3 1.23.96-.267 1.98-.399 3-.405 1.02.006 2.04.138 3 .405 2.28-1.552 3.285-1.23 3.285-1.23.645 1.653.24 2.873.12 3.176.765.84 1.23 1.91 1.23 3.22 0 4.61-2.805 5.625-5.475 5.92.42.36.81 1.096.81 2.22 0 1.606-.015 2.896-.015 3.286 0 .315.21.69.825.57C20.565 22.092 24 17.592 24 12.297c0-6.627-5.373-12-12-12",
+    },
+    forgejo: {
+        name: "Forgejo",
+        path: "M16.7773 0c1.6018 0 2.9004 1.2986 2.9004 2.9005s-1.2986 2.9004-2.9004 2.9004c-1.0854 0-2.0315-.596-2.5288-1.4787H12.91c-2.3322 0-4.2272 1.8718-4.2649 4.195l-.0007 2.1175a7.0759 7.0759 0 0 1 4.148-1.4205l.1176-.001 1.3385.0002c.4973-.8827 1.4434-1.4788 2.5288-1.4788 1.6018 0 2.9004 1.2986 2.9004 2.9005s-1.2986 2.9004-2.9004 2.9004c-1.0854 0-2.0315-.596-2.5288-1.4787H12.91c-2.3322 0-4.2272 1.8718-4.2649 4.195l-.0007 2.319c.8827.4973 1.4788 1.4434 1.4788 2.5287 0 1.602-1.2986 2.9005-2.9005 2.9005-1.6018 0-2.9004-1.2986-2.9004-2.9005 0-1.0853.596-2.0314 1.4788-2.5287l-.0002-9.9831c0-3.887 3.1195-7.0453 6.9915-7.108l.1176-.001h1.3385C14.7458.5962 15.692 0 16.7773 0ZM7.2227 19.9052c-.6596 0-1.1943.5347-1.1943 1.1943s.5347 1.1943 1.1943 1.1943 1.1944-.5347 1.1944-1.1943-.5348-1.1943-1.1944-1.1943Zm9.5546-10.4644c-.6596 0-1.1944.5347-1.1944 1.1943s.5348 1.1943 1.1944 1.1943c.6596 0 1.1943-.5347 1.1943-1.1943s-.5347-1.1943-1.1943-1.1943Zm0-7.7346c-.6596 0-1.1944.5347-1.1944 1.1943s.5348 1.1943 1.1944 1.1943c.6596 0 1.1943-.5347 1.1943-1.1943s-.5347-1.1943-1.1943-1.1943Z",
+    },
+};

package/dist/repository/components/backup/remote-restore.d.ts

@@ -0,0 +1,3 @@
+import type { RepositoryPlugin } from "../repository-plugin.js";
+import type { RemoteService } from "../../controllers/remote.js";
+export declare function createRemoteRestore(plugin: RepositoryPlugin, remote: RemoteService): import("../../controllers/restore.js").RestoreController | undefined;

package/dist/repository/components/backup/remote-restore.js

@@ -0,0 +1,17 @@
+import { remoteRestore } from "../../controllers/remote.js";
+import { BackgroundWork } from "../../controllers/background-work.js";
+import { createRestoreController } from "../restore-controller.js";
+export function createRemoteRestore(plugin, remote) {
+    const service = remoteRestore(remote);
+    const activity = new BackgroundWork(plugin.app.notifications, plugin.id);
+    return createRestoreController(plugin, {
+        key: "pendingRemoteRestore",
+        title: "Restore remote backup",
+        service: {
+            ...service,
+            previewVault: (checkpoint) => activity.run("Preparing remote restore", () => remote.preview(checkpoint)),
+            applyVault: (request) => activity.run("Restoring remote backup", () => remote.restore(request)),
+            keepCurrent: () => activity.run("Keeping current vault files", () => remote.keepCurrent()),
+        },
+    });
+}

package/dist/repository/components/backup/storage-settings.d.ts

@@ -0,0 +1,8 @@
+import type { RepositoryPlugin } from "../repository-plugin.js";
+import type { StorageService } from "../../controllers/storage.js";
+import { StorageController } from "../../controllers/storage-controller.js";
+/** A move belongs to the enabled plugin, not the tab that requested it. */
+export declare function storageSettings(plugin: RepositoryPlugin, service?: StorageService): {
+    controller: StorageController;
+    close(): Promise<void>;
+} | undefined;

package/dist/repository/components/backup/storage-settings.js

@@ -0,0 +1,23 @@
+import { StorageController } from "../../controllers/storage-controller.js";
+import { BackgroundWork } from "../../controllers/background-work.js";
+/** A move belongs to the enabled plugin, not the tab that requested it. */
+export function storageSettings(plugin, service) {
+    if (!service)
+        return undefined;
+    const controller = new StorageController(service, plugin.feedback("History storage", "repository-history:storage"), (action) => plugin.app.fileEditingSessions.guard(undefined, async () => {
+        await plugin.backup?.controller.pause();
+        await plugin.backup?.sync?.controller.drained();
+        return action();
+    }));
+    const progress = new BackgroundWork(plugin.app.notifications, plugin.id).follow("Moving history storage", {
+        subscribe: (listener) => controller.subscribeActivity(listener),
+    });
+    return {
+        controller,
+        async close() {
+            controller.close();
+            await controller.drained();
+            progress();
+        },
+    };
+}