feat: add encrypted online settings backup keys

Add immutable client-encrypted settings snapshots with independent MDD2 capability keys so fresh installs can restore configuration without transferring backup files. Keep credentials encrypted end to end, preserve queues and history during import, and avoid exposing identifiers in request URLs or errors. Include the persistent API with quota, rate limits, crash-safe storage locking, durability checks, and end-to-end race and recovery coverage.

src/main/app-controller.ts

@@ -25,7 +25,7 @@ import {
 } from "../shared/types";
 import { resetDebridLinkApiKeyDailyUsage, resetProviderDailyUsage } from "../shared/provider-daily-limits";
 import { importDlcContainers } from "./container";
-import { APP_VERSION } from "./constants";
+import { APP_VERSION, ONLINE_BACKUP_API_URL } from "./constants";
 import { DownloadManager } from "./download-manager";
 import { fetchAllDebridHostInfo, fetchDebridLinkHostLimits } from "./debrid";
 import { checkAllDebridAccounts, checkMegaDebridAccount } from "./account-check";
@@ -57,7 +57,8 @@ import { getDesktopRenameLogPath, initDesktopRenameLog, shutdownDesktopRenameLog
 import { buildAccountSummary, diffAccountSummary } from "./support-data";
 import { buildSupportBundle, getSupportBundleDefaultFileName } from "./support-bundle";
 import { getTraceConfig, getTraceLogPath, initTraceLog, logTraceEvent, setTraceEnabled, shutdownTraceLog } from "./trace-log";
-import type { DebugSetupCheckResult, SupportTraceConfig } from "../shared/types";
+import type { DebugSetupCheckResult, SupportTraceConfig } from "../shared/types";
+import { createOnlineBackup, downloadOnlineBackup, uploadOnlineBackup } from "./online-backup";
 
 function sanitizeSettingsPatch(partial: Partial<AppSettings>): Partial<AppSettings> {
   const entries = Object.entries(partial || {}).filter(([, value]) => value !== undefined);
@@ -415,7 +416,7 @@ export class AppController {
   // object about to be applied, so they are never rolled back to a stale snapshot.
   // All-time totals take the max; daily/total usage and account statuses are taken
   // live; per-key Debrid-Link usage is filtered to keys that still exist.
-  private overlayLiveUsageCounters(target: AppSettings): void {
+  private overlayLiveUsageCounters(target: AppSettings): void {
     const liveSettings = this.manager.getSettings();
     target.totalDownloadedAllTime = Math.max(target.totalDownloadedAllTime || 0, liveSettings.totalDownloadedAllTime || 0);
     target.totalCompletedFilesAllTime = Math.max(target.totalCompletedFilesAllTime || 0, liveSettings.totalCompletedFilesAllTime || 0);
@@ -429,8 +430,19 @@ export class AppController {
     target.debridLinkApiKeyTotalUsageBytes = Object.fromEntries(
       Object.entries(liveSettings.debridLinkApiKeyTotalUsageBytes || {}).filter(([keyId]) => getDebridLinkApiKeyIds(target.debridLinkApiKeys).includes(keyId))
     );
-    target.debridAccountStatuses = { ...(liveSettings.debridAccountStatuses || {}) };
-  }
+    target.debridAccountStatuses = { ...(liveSettings.debridAccountStatuses || {}) };
+  }
+
+  private applySettingsOnlyBackup(importedSettings: AppSettings, remoteDiagnostics?: unknown, restoreRemoteDiagnostics = false): void {
+    const restoredSettings = normalizeSettings(importedSettings);
+    this.overlayLiveUsageCounters(restoredSettings);
+    this.settings = restoredSettings;
+    saveSettings(this.storagePaths, this.settings);
+    this.manager.setSettings(this.settings, { settingsOnlyImport: true });
+    if (restoreRemoteDiagnostics) {
+      this.restoreRemoteDiagnosticsFromBackup(remoteDiagnostics, true);
+    }
+  }
 
   public updateSettings(partial: Partial<AppSettings>): AppSettings {
     const sanitizedPatch = sanitizeSettingsPatch(partial);
@@ -747,7 +759,7 @@ public async checkDebridAccounts(): Promise<DebridAccountStatus[]> {
     this.audit("INFO", "Download-Statistik zurückgesetzt");
   }
 
-  public exportBackup(): Buffer {
+  public exportBackup(): Buffer {
     let remoteDiagnostics: BackupRemoteDiagnostics | undefined;
     if (Boolean(this.settings.backupIncludeRemoteDiagnostics)) {
       const status = getDebugServerRuntimeStatus();
@@ -771,8 +783,25 @@ public async checkDebridAccounts(): Promise<DebridAccountStatus[]> {
       sessionItems: payloadObj.session ? Object.keys(payloadObj.session.items).length : 0,
       sessionPackages: payloadObj.session ? Object.keys(payloadObj.session.packages).length : 0
     });
-    return encryptBackup(JSON.stringify(payloadObj));
-  }
+    return encryptBackup(JSON.stringify(payloadObj));
+  }
+
+  public async exportOnlineBackup(): Promise<{ key: string }> {
+    const created = createOnlineBackup({ ...this.settings }, APP_VERSION);
+    await uploadOnlineBackup(created.record, ONLINE_BACKUP_API_URL);
+    this.audit("INFO", "Online-Sicherung erstellt", { kind: "settings-only" });
+    return { key: created.key };
+  }
+
+  public async importOnlineBackup(key: string): Promise<{ restored: boolean; relaunch: false; message: string }> {
+    const payload = await downloadOnlineBackup(key, ONLINE_BACKUP_API_URL);
+    this.applySettingsOnlyBackup(payload.settings);
+    this.audit("INFO", "Online-Sicherung importiert", {
+      kind: "settings-only",
+      accountSummary: buildAccountSummary(this.settings)
+    });
+    return { restored: true, relaunch: false, message: "Einstellungen aus Online-Sicherung wiederhergestellt" };
+  }
 
   public async exportSupportBundle(): Promise<{ buffer: Buffer; defaultFileName: string }> {
     this.audit("INFO", "Support-Bundle exportiert");
@@ -824,20 +853,16 @@ public async checkDebridAccounts(): Promise<DebridAccountStatus[]> {
         importedSettingsRecord[key] = currentSettingsRecord[key];
       }
     }
-    const restoredSettings = normalizeSettings(importedSettings);
+    const restoredSettings = normalizeSettings(importedSettings);
 
     // Settings-only backup: keep the running queue AND the live counters untouched.
     // Overlay the live usage/status counters so they don't roll back to the backup's
     // (older) snapshot (BUG I), and suppress the retroactive cleanup sweep so the
     // backup's cleanup policy can't purge the live completed queue here (BUG B) — the
     // policy still governs FUTURE completions through the normal path. Do NOT stop the
-    // manager, wipe the session, block persistence or relaunch.
-    if (!hasSession) {
-      this.overlayLiveUsageCounters(restoredSettings);
-      this.settings = restoredSettings;
-      saveSettings(this.storagePaths, this.settings);
-      this.manager.setSettings(this.settings, { suppressRetroactiveCleanup: true });
-      this.restoreRemoteDiagnosticsFromBackup(parsed.remoteDiagnostics, true);
+    // manager, wipe the session, block persistence or relaunch.
+    if (!hasSession) {
+      this.applySettingsOnlyBackup(restoredSettings, parsed.remoteDiagnostics, true);
       this.audit("INFO", "Backup importiert (nur Einstellungen)", {
         accountSummary: buildAccountSummary(this.settings)
       });

src/main/constants.ts

@@ -38,6 +38,7 @@ export const SPEED_WINDOW_SECONDS = 1;
 export const CLIPBOARD_POLL_INTERVAL_MS = 2000;
 
 export const DEFAULT_UPDATE_REPO = "Sucukdeluxe/multi-debrid-downloader";
+export const ONLINE_BACKUP_API_URL = "https://backup.24-music.de";
 
 export function defaultSettings(): AppSettings {
   const baseDir = path.join(os.homedir(), "Downloads", "RealDebrid");

src/main/download-manager.ts

@@ -2156,7 +2156,7 @@ export class DownloadManager extends EventEmitter {
     this.emitState();
   }
 
-  public setSettings(next: AppSettings, opts?: { suppressRetroactiveCleanup?: boolean }): void {
+  public setSettings(next: AppSettings, opts?: { suppressRetroactiveCleanup?: boolean; settingsOnlyImport?: boolean }): void {
     const previous = this.settings;
     next.totalDownloadedAllTime = Math.max(next.totalDownloadedAllTime || 0, this.settings.totalDownloadedAllTime || 0);
     next.totalCompletedFilesAllTime = Math.max(next.totalCompletedFilesAllTime || 0, this.settings.totalCompletedFilesAllTime || 0);
@@ -2174,7 +2174,7 @@ export class DownloadManager extends EventEmitter {
     const nextOrder = JSON.stringify(next.providerOrder ?? []);
     const prevRouting = JSON.stringify(previous.hosterRouting ?? {});
     const nextRouting = JSON.stringify(next.hosterRouting ?? {});
-    if (prevOrder !== nextOrder || prevRouting !== nextRouting) {
+    if (!opts?.settingsOnlyImport && (prevOrder !== nextOrder || prevRouting !== nextRouting)) {
       const activeItemIds = new Set([...this.activeTasks.values()].map((t) => t.itemId));
       for (const item of Object.values(this.session.items)) {
         if (!activeItemIds.has(item.id) && item.status !== "completed" && item.status !== "failed") {
@@ -2185,7 +2185,7 @@ export class DownloadManager extends EventEmitter {
 
     const previousArchivePasswords = String(previous.archivePasswordList || "").replace(/\r\n|\r/g, "\n");
     const nextArchivePasswords = String(next.archivePasswordList || "").replace(/\r\n|\r/g, "\n");
-    if (previousArchivePasswords !== nextArchivePasswords) {
+    if (!opts?.settingsOnlyImport && previousArchivePasswords !== nextArchivePasswords) {
       this.hybridExtractedPaths.clear();
       this.hybridFailedArchives.clear();
       const pwCount = nextArchivePasswords.split("\n").filter(Boolean).length;
@@ -2218,10 +2218,12 @@ export class DownloadManager extends EventEmitter {
       logger.info(`Settings-Update: ${clearedProviderFailures} Provider-Failure(s) gecleart wegen geaenderter Credentials`);
     }
 
-    this.resolveExistingQueuedOpaqueFilenames();
-    void this.cleanupExistingExtractedArchives().catch((err) => logger.warn(`cleanupExistingExtractedArchives Fehler (setSettings): ${compactErrorText(err)}`));
-    if (!opts?.suppressRetroactiveCleanup && next.completedCleanupPolicy !== "never") {
-      this.applyRetroactiveCleanupPolicy();
+    if (!opts?.settingsOnlyImport) {
+      this.resolveExistingQueuedOpaqueFilenames();
+      void this.cleanupExistingExtractedArchives().catch((err) => logger.warn(`cleanupExistingExtractedArchives Fehler (setSettings): ${compactErrorText(err)}`));
+      if (!opts?.suppressRetroactiveCleanup && next.completedCleanupPolicy !== "never") {
+        this.applyRetroactiveCleanupPolicy();
+      }
     }
     this.emitState();
   }

src/main/main.ts

@@ -569,7 +569,7 @@ function registerIpcHandlers(): void {
     app.quit();
   });
 
-  ipcMain.handle(IPC_CHANNELS.EXPORT_BACKUP, async () => {
+  ipcMain.handle(IPC_CHANNELS.EXPORT_BACKUP, async () => {
     const options = {
       defaultPath: `${new Date().toISOString().slice(0, 10).split("-").reverse().join("-")}-mdd-backup.mdd`,
       filters: [{ name: "MDD Backup", extensions: ["mdd"] }]
@@ -580,8 +580,18 @@ function registerIpcHandlers(): void {
     }
     const encrypted = controller.exportBackup();
     await fs.promises.writeFile(result.filePath, encrypted);
-    return { saved: true };
-  });
+    return { saved: true };
+  });
+
+  ipcMain.handle(IPC_CHANNELS.EXPORT_ONLINE_BACKUP, async () => controller.exportOnlineBackup());
+
+  ipcMain.handle(IPC_CHANNELS.IMPORT_ONLINE_BACKUP, async (_event: IpcMainInvokeEvent, rawKey: unknown) => {
+    const key = validateString(rawKey, "key").trim();
+    if (key.length > 128) {
+      throw new Error("Online-Sicherungsschlüssel ist ungültig");
+    }
+    return controller.importOnlineBackup(key);
+  });
 
   ipcMain.handle(IPC_CHANNELS.EXPORT_SUPPORT_BUNDLE, async () => {
     const options = {

src/main/online-backup.ts

@@ -0,0 +1,273 @@
+import crypto from "node:crypto";
+import zlib from "node:zlib";
+import type { AppSettings } from "../shared/types";
+
+const KEY_PREFIX = "MDD2-";
+const KEY_BODY_LENGTH = 70;
+const RECORD_ID_LENGTH = 16;
+const MASTER_KEY_LENGTH = 32;
+const CHECKSUM_LENGTH = 4;
+const NONCE_LENGTH = 12;
+const AUTH_TAG_LENGTH = 16;
+const BLOB_VERSION = 1;
+const MAX_BLOB_BYTES = 256 * 1024;
+const MAX_RESPONSE_BYTES = 512 * 1024;
+const MAX_PLAINTEXT_BYTES = 512 * 1024;
+const REQUEST_TIMEOUT_MS = 12_000;
+const KEY_CONTEXT = Buffer.from("MDD2-ONLINE-KEY-V1", "utf8");
+const AAD_CONTEXT = Buffer.from("MDD-ONLINE-BACKUP-V1", "utf8");
+
+export interface OnlineSettingsPayload {
+  version: 1;
+  kind: "settings-only";
+  appVersion: string;
+  exportedAt: string;
+  settings: AppSettings;
+}
+
+export interface OnlineBackupRecord {
+  id: string;
+  blob: string;
+  deleteVerifier: string;
+}
+
+export interface CreatedOnlineBackup {
+  key: string;
+  record: OnlineBackupRecord;
+}
+
+export interface ParsedOnlineBackupKey {
+  id: string;
+  idBytes: Buffer;
+  masterKey: Buffer;
+}
+
+function checksum(idBytes: Buffer, masterKey: Buffer): Buffer {
+  return crypto.createHash("sha256").update(KEY_CONTEXT).update(idBytes).update(masterKey).digest().subarray(0, CHECKSUM_LENGTH);
+}
+
+function deriveSecret(masterKey: Buffer, idBytes: Buffer, purpose: string): Buffer {
+  return Buffer.from(crypto.hkdfSync("sha256", masterKey, idBytes, Buffer.from(`MDD-ONLINE-${purpose}-V1`, "utf8"), 32));
+}
+
+function deriveDeleteSecret(parsed: ParsedOnlineBackupKey): Buffer {
+  return deriveSecret(parsed.masterKey, parsed.idBytes, "DELETE");
+}
+
+function aad(idBytes: Buffer): Buffer {
+  return Buffer.concat([AAD_CONTEXT, idBytes]);
+}
+
+function encodeKey(idBytes: Buffer, masterKey: Buffer): string {
+  const body = Buffer.concat([idBytes, masterKey, checksum(idBytes, masterKey)]).toString("base64url");
+  return `${KEY_PREFIX}${body}`;
+}
+
+function validatePayload(value: unknown): OnlineSettingsPayload {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    throw new Error("Online-Sicherung enthält keine gültigen Einstellungen");
+  }
+  const record = value as Record<string, unknown>;
+  if (
+    record.version !== 1
+    || record.kind !== "settings-only"
+    || typeof record.appVersion !== "string"
+    || typeof record.exportedAt !== "string"
+    || !record.settings
+    || typeof record.settings !== "object"
+    || Array.isArray(record.settings)
+    || "session" in record
+    || "history" in record
+  ) {
+    throw new Error("Online-Sicherung enthält keine gültigen Einstellungen");
+  }
+  return record as unknown as OnlineSettingsPayload;
+}
+
+function endpoint(baseUrl: string, relativePath: string): string {
+  const normalized = String(baseUrl || "").trim().replace(/\/+$/, "");
+  const url = new URL(`${normalized}${relativePath}`);
+  if (url.protocol !== "https:" && !["127.0.0.1", "localhost", "::1"].includes(url.hostname)) {
+    throw new Error("Online-Sicherungen benötigen eine sichere HTTPS-Verbindung");
+  }
+  return url.toString();
+}
+
+async function request(url: string, init?: RequestInit): Promise<Response> {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+  try {
+    return await fetch(url, { ...init, signal: controller.signal });
+  } catch (error) {
+    if (controller.signal.aborted) {
+      throw new Error("Online-Sicherungsdienst antwortet nicht");
+    }
+    throw new Error(`Online-Sicherungsdienst nicht erreichbar: ${String((error as Error)?.message || error)}`);
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+async function readLimitedText(response: Response): Promise<string> {
+  const contentLength = Number(response.headers.get("content-length") || "0");
+  if (Number.isFinite(contentLength) && contentLength > MAX_RESPONSE_BYTES) {
+    throw new Error("Antwort des Online-Sicherungsdienstes ist zu groß");
+  }
+  if (!response.body) return "";
+  const reader = response.body.getReader();
+  const chunks: Uint8Array[] = [];
+  let total = 0;
+  while (true) {
+    const result = await reader.read();
+    if (result.done) break;
+    total += result.value.byteLength;
+    if (total > MAX_RESPONSE_BYTES) {
+      await reader.cancel();
+      throw new Error("Antwort des Online-Sicherungsdienstes ist zu groß");
+    }
+    chunks.push(result.value);
+  }
+  return Buffer.concat(chunks.map((chunk) => Buffer.from(chunk))).toString("utf8");
+}
+
+export function parseOnlineBackupKey(key: string): ParsedOnlineBackupKey {
+  const normalized = String(key || "").trim();
+  if (!new RegExp(`^${KEY_PREFIX}[A-Za-z0-9_-]{${KEY_BODY_LENGTH}}$`).test(normalized)) {
+    throw new Error("Online-Sicherungsschlüssel ist ungültig");
+  }
+  const decoded = Buffer.from(normalized.slice(KEY_PREFIX.length), "base64url");
+  if (decoded.length !== RECORD_ID_LENGTH + MASTER_KEY_LENGTH + CHECKSUM_LENGTH) {
+    throw new Error("Online-Sicherungsschlüssel ist ungültig");
+  }
+  if (decoded.toString("base64url") !== normalized.slice(KEY_PREFIX.length)) {
+    throw new Error("Online-Sicherungsschlüssel ist ungültig");
+  }
+  const idBytes = decoded.subarray(0, RECORD_ID_LENGTH);
+  const masterKey = decoded.subarray(RECORD_ID_LENGTH, RECORD_ID_LENGTH + MASTER_KEY_LENGTH);
+  const actualChecksum = decoded.subarray(RECORD_ID_LENGTH + MASTER_KEY_LENGTH);
+  const expectedChecksum = checksum(idBytes, masterKey);
+  if (!crypto.timingSafeEqual(actualChecksum, expectedChecksum)) {
+    throw new Error("Online-Sicherungsschlüssel ist beschädigt");
+  }
+  return { id: idBytes.toString("base64url"), idBytes: Buffer.from(idBytes), masterKey: Buffer.from(masterKey) };
+}
+
+export function createOnlineBackup(settings: AppSettings, appVersion: string, exportedAt = new Date().toISOString()): CreatedOnlineBackup {
+  const idBytes = crypto.randomBytes(RECORD_ID_LENGTH);
+  const masterKey = crypto.randomBytes(MASTER_KEY_LENGTH);
+  const key = encodeKey(idBytes, masterKey);
+  const encryptionKey = deriveSecret(masterKey, idBytes, "ENCRYPTION");
+  const nonce = crypto.randomBytes(NONCE_LENGTH);
+  const payload: OnlineSettingsPayload = {
+    version: 1,
+    kind: "settings-only",
+    appVersion,
+    exportedAt,
+    settings: JSON.parse(JSON.stringify(settings)) as AppSettings
+  };
+  const plaintext = Buffer.from(JSON.stringify(payload), "utf8");
+  if (plaintext.length > MAX_PLAINTEXT_BYTES) {
+    throw new Error("Einstellungen sind für eine Online-Sicherung zu groß");
+  }
+  const compressed = zlib.gzipSync(plaintext, { level: 9 });
+  const cipher = crypto.createCipheriv("aes-256-gcm", encryptionKey, nonce, { authTagLength: AUTH_TAG_LENGTH });
+  cipher.setAAD(aad(idBytes));
+  const ciphertext = Buffer.concat([cipher.update(compressed), cipher.final()]);
+  const blobBytes = Buffer.concat([Buffer.from([BLOB_VERSION]), nonce, cipher.getAuthTag(), ciphertext]);
+  if (blobBytes.length > MAX_BLOB_BYTES) {
+    throw new Error("Einstellungen sind für eine Online-Sicherung zu groß");
+  }
+  const parsed = parseOnlineBackupKey(key);
+  const deleteVerifier = crypto.createHash("sha256").update(deriveDeleteSecret(parsed)).digest("base64url");
+  return {
+    key,
+    record: {
+      id: parsed.id,
+      blob: blobBytes.toString("base64url"),
+      deleteVerifier
+    }
+  };
+}
+
+export function restoreOnlineBackup(key: string, blob: string): OnlineSettingsPayload {
+  const parsed = parseOnlineBackupKey(key);
+  if (!/^[A-Za-z0-9_-]+$/.test(blob) || blob.length > Math.ceil(MAX_BLOB_BYTES * 4 / 3) + 4) {
+    throw new Error("Online-Sicherung ist beschädigt");
+  }
+  const bytes = Buffer.from(blob, "base64url");
+  if (bytes.toString("base64url") !== blob) {
+    throw new Error("Online-Sicherung ist beschädigt");
+  }
+  if (bytes.length < 1 + NONCE_LENGTH + AUTH_TAG_LENGTH || bytes[0] !== BLOB_VERSION) {
+    throw new Error("Online-Sicherung ist beschädigt");
+  }
+  const nonce = bytes.subarray(1, 1 + NONCE_LENGTH);
+  const tag = bytes.subarray(1 + NONCE_LENGTH, 1 + NONCE_LENGTH + AUTH_TAG_LENGTH);
+  const ciphertext = bytes.subarray(1 + NONCE_LENGTH + AUTH_TAG_LENGTH);
+  try {
+    const decipher = crypto.createDecipheriv(
+      "aes-256-gcm",
+      deriveSecret(parsed.masterKey, parsed.idBytes, "ENCRYPTION"),
+      nonce,
+      { authTagLength: AUTH_TAG_LENGTH }
+    );
+    decipher.setAAD(aad(parsed.idBytes));
+    decipher.setAuthTag(tag);
+    const compressed = Buffer.concat([decipher.update(ciphertext), decipher.final()]);
+    const plaintext = zlib.gunzipSync(compressed, { maxOutputLength: MAX_PLAINTEXT_BYTES }).toString("utf8");
+    return validatePayload(JSON.parse(plaintext));
+  } catch (error) {
+    if (error instanceof Error && /keine gültigen Einstellungen/.test(error.message)) throw error;
+    throw new Error("Online-Sicherung konnte nicht entschlüsselt werden oder ist beschädigt");
+  }
+}
+
+export async function uploadOnlineBackup(record: OnlineBackupRecord, baseUrl: string): Promise<void> {
+  const response = await request(endpoint(baseUrl, "/v1/backups"), {
+    method: "POST",
+    headers: { "content-type": "application/json", accept: "application/json" },
+    body: JSON.stringify(record)
+  });
+  await readLimitedText(response);
+  if (response.status !== 201) {
+    throw new Error("Online-Sicherung konnte nicht gespeichert werden");
+  }
+}
+
+export async function downloadOnlineBackup(key: string, baseUrl: string): Promise<OnlineSettingsPayload> {
+  const parsed = parseOnlineBackupKey(key);
+  const response = await request(endpoint(baseUrl, "/v1/backups/restore"), {
+    method: "POST",
+    headers: { "content-type": "application/json", accept: "application/json" },
+    body: JSON.stringify({ id: parsed.id })
+  });
+  const body = await readLimitedText(response);
+  if (response.status !== 200) {
+    throw new Error(response.status === 404 ? "Online-Sicherung wurde nicht gefunden" : "Online-Sicherung konnte nicht geladen werden");
+  }
+  let value: unknown;
+  try {
+    value = JSON.parse(body);
+  } catch {
+    throw new Error("Online-Sicherungsdienst hat ungültige Daten geliefert");
+  }
+  const blob = (value as { blob?: unknown })?.blob;
+  if (typeof blob !== "string") {
+    throw new Error("Online-Sicherungsdienst hat ungültige Daten geliefert");
+  }
+  return restoreOnlineBackup(key, blob);
+}
+
+export async function deleteOnlineBackup(key: string, baseUrl: string): Promise<void> {
+  const parsed = parseOnlineBackupKey(key);
+  const deleteSecret = deriveDeleteSecret(parsed).toString("base64url");
+  const response = await request(endpoint(baseUrl, "/v1/backups/delete"), {
+    method: "POST",
+    headers: { "content-type": "application/json", accept: "application/json" },
+    body: JSON.stringify({ id: parsed.id, deleteSecret })
+  });
+  if (response.status !== 204) {
+    await readLimitedText(response);
+    throw new Error(response.status === 404 ? "Online-Sicherung wurde nicht gefunden" : "Online-Sicherung konnte nicht gelöscht werden");
+  }
+}